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FOREWORD 


MUMPS-11 is an interactive, interpretive language, multi- 
user operating system for the PDP-11l that allows access to 
a common data base. The capabilities of the system are 
heavily oriented towards string manipulation using a 

high level language. The system relieves the user of 

any concern for programming peripheral devices or for 
structuring data bases in the traditional sense, 


Language processing by the system is in every sense inter- 
pretive. Each line of code undergoes identical processing 
each time it is executed (intermediate code is not gener- 
ated). “The MUMPS applications programmer is relieved of 

all the burdens associated with driving peripheral equipment 
or assembly language programming. He may concentrate his 
energies on the analytical aspects of his problem. His 
major problems are: developing proper logical hierarchy 

for his data base, and developing efficient logic for his 


data processing requirement. 


The MUMPS language is provided with its own stand-alone 
operating system. In addition to supporting the MUMPS 
language and providing all operating system capabilities, 

the system affords the user a unique data base structure 

and access method. Data which is referred to symbolically 
is automatically stored and linked in a tree structure. 

The physical allocation of mass storage for the tree- 
structured data base is accomplished by the operating system. 
The data base thus created can be made available either to 


all system users or to a class of system users. 


Xi 


PREFACE 


The MUMPS-11 Programmer's Guide is a reference manual 
designed to give the programmer all the information required 
to create, execute, and save MUMPS Language programs in 

the MUMPS-11l system environment. Chapter 1 provides a 
system overview which includes information on the MUMPS 
System Software/Hardware environment and the functions 


performed by the various modules of the operating system. 


Chapter 2 provides complete information on the use of the 
MUMPS terminal. Specific subject areas covered are, log-in/ 
log-out procedures and how to create, modify, run, save, 


and delete programs. 


Chapter 3 contains general information on the use of I/O 
devices in MUMPS programs and specific operating informa- 
tion on each. 


Chapter 4 describes the MUMPS Library Utility Programs, 
their functional characteristics and how’ to run them. In 
addition, information is provided which describes how to 


create Library Programs and Globals. 


Chapter 5 discusses various programming considerations and 
techniques for the application and system programmers. 
Included are data base design considerations and the use of 


special elements of the MUMPS-11 language. 


Appendices A through E are general reference sections for 
the application programmer, including a glossary, the 
system's error messages, and useful tables. Appendices F 
and G describe the internal system structure for the 
system programmer. Appendix I describes the conventions 
and characteristics of an I/O device driver for those 


users who wish to add devices to the system. 


X111 


The MUMPS-11 Language Reference Manual is a prerequisite 
to complete understanding of this manual. The MUMPS-11 
Operator's Guide contains information of specific interest 
to system operators and managers. The Introduction to 
MUMPS-11 Language is a tutorial manual that describes the 
MUMPS-11 language and data base in a step-by-step manner. 


The following symbols are used throughout this manual: 


Symbol Definition 
Revision bar. Indicates differences 
between this manual and the previous 
edition. 

» Universal symbol for line terminator. 


Line terminators for terminals are 
either Carriage RETURN or ALT MODE. 


boeenl A single space. 
t 3 Fields described within braces are 
optional. 


| | Vertical bars are used to contain a 
list of options among which a single 
choice must be made. 


CTRL Used with special system control 
characters. Depress CTRL key while 
striking designated character. 


UNDERLINING All examples of user-typed terminal 
input are underlined. 


4U or “U Echo for CTRL/U keyboard command. 
\ Backslash - echo for RUBOUT keyboard 
command. 
BREAK Operation of BREAK key. 


Xiv 


CHAPTER 1 
INTRODUCTION 


1.1 SYSTEM OVERVIEW 


The MUMPS-11 system is a multi-user, time-sharing system which runs 

on the PDP-11 computer. Utilizing the high-level, interactive, string- 
oriented MUMPS-11 interpretive language, the system permits up to 40 
simultaneous users, operating on any of the system's 65 terminals, to 
interact with a common tree-structured data base. The system is 
specifically designed to manipulate strings of data and to increase or 


decrease the size of data storage areas on the disk. 


Additional features include: 


® Variable length data elements and logical records 

e Random access of data uSing multiple keys 

6 Variety of terminal and peripheral devices 

S System utilities for backup, validation and reporting. 


The PDP-11 is used as the Central Processor. It has a 16-bit word 


length and can be expanded from 49,152 to 245,760 bytes of memory. 


Both fixed-head and removable disk pack systems are used for on-line 
storage of user programs, the data base, and system utility programs. 
The maximum on-line storage that the system can provide is approxi- 
mately 417 million words. 


A variety of terminals and printers are also supported, including: 
ASR-33 and ASR-35 Teletypes’, LA30, LA36 DECwriters, LA180 matrix 
printers and VT05, VT50, VT52, and VT55 video terminals. In addition, 
the system can utilize other Teletype-like devices which can be 
connected to DIGITAL KL11, DL11l, DCl1l, DH11 or DZ11 controllers. 


Other standard peripherals supported by MUMPS-11 include industry- 
compatible disk, magnetic tape, DECtape, paper tape reader/punch, 
and line printer. 


Imeletype is a registered trademark of Teletype Corporation. 


ii 


The MUMPS Language contains a large repertoire of capabilities. 

The basic orientation of MUMPS-11 is procedural, much like FORTRAN 
or COBOL. Its capabilities are primarily directed toward the proc- 
essing of variable length string data. In addition, standard 
algebraic and Boolean operations are also available. Data is 
represented in either string or numeric form, and mixed mode 
Operations are expressly permitted. The language also allows 


assembly language-like bit manipulation operations. 


Language processing is in every sense interpretive. Each line of 

a MUMPS command undergoes identical processing each time it is © 
executed (intermediate code is not generated). The language inter- 
preter has two operating modes: program execution mode (Indirect 
Mode) and program creation mode (Direct Mode). In Direct Mode, 
programs can be created, modified, debugged, and stored. Indirect 


Mode operation permits the execution of these programs. 


The operating system is highly modular and resides permanently in 
memory (Figure 1-1). The system uses between 22K and 40K bytes of 
memory, depending on the hardware configuration. During system 
generation, the remaining memory is subdivided into user partitions? 
which are used to contain user programs. A partition holds one active 
user's program, local data, and system overhead data. There is no 
fixed correspondence between terminals and partitions. Assignment 

is performed dynamically at log-in time. The recommended size for 
partitions is approximately 4096 bytes each, but they do not all have 
to be the same size. A user's terminal is assigned the next available 
partition. | . 

Each active user requiring CPU time obtains a time slice in turn. A 
checkpoint form of timesharing is utilized whereby a program is 
allowed to execute until its time slice has expired, plus any additional 
time required to complete a current operation. Control then passes 


to the next job (in priority order) requiring service. 


I1Machines with no more than 28K words of memory may have a maximum of 
18 partitions. Machines with more than 28K bytes of memory may have 
a maximum of 40 partitions. 


PARTITION 
SPACE 
SYSTEM BUFFERS 
DATA BASE SUPERVISOR OPERATING 
INTERPRETER SYSTEM 


1/0 MONITOR AND DRIVERS 
EXECUTIVE 


Figure 1-1 MUMPS-11 Memory Layout 


The data management features of the system allow local data utilized 
by a program to be referenced symbolically. Storage space for this 
data is allocated as needed. Local data is that set of variables 
established within the domain of a particular partition and is defined 
only for programs within that partition. This form of storage is used 
for scratch or transient data. These local data arrays are treated 

as if they are intended to be sparse. That is, only subscripts for 
which data are defined are allocated space. A symbolic variable used 
in a program may be given either a numeric value or a variable length 
string value. When it has a string value, only that BPace ie cae 
required by the string is allocated. 


This philosophy is extended to the management of data on the random 
access disk system. All elements stored in data files are referenced 
symbolically; the file name is similar to that of a symbolic local 
variable name in a program. Records in the data file are treated as 
array elements and are referenced by means of subscripts; subrecords 
are referenced by appending additional subscripts. Data files on 

the disk thus comprise an external system of arrays, which provide a 
common data base available to all programs within a given user 

class. The arrays which make up this external system are called > 


global arrays. Each global array is identified by a unique name. 


The structure of global arrays is hierarchical. Any element within 
an array tree may possess a numeric or string data value and (or) be 
a pointer to a lower level in the tree. Data may be stored at any 


level. There are no constraints upon the dimension or the size of an 
array. In addition, the number of subscripts in an array is dynamic, 
so that its content and structure may change during usage. 


In addition to storing global data files, the disk is also used to 
contain MUMPS Language programs including the System Utility Pro- 
grams and user-created programs. 


The availability of programs and global data to users is controlled 
by the system's protection scheme. Up to sixteen classes of users 
can be defined within the system. Each user class has access only 
to those programs and globals residing in that class. Further, 
specially named library programs residing in UCI #1 (the System UCI) 
can be accessed by all users. Using an easily modifiable password 
at log-in time allows access to an associated user class. This 
password, called a User Class Identifier (UCI)!, allows Indirect Mode 
Operation; i.e., programs can be run, but not changed, and global 
data can be read or written by these programs. An additional code 
called the Programmer Access Code (PAC)! can be used with any UCI 
code to permit Direct Mode operation. This allows programs and 
global files ina particular user class to be created and modified. 


A set of MUMPS Language Utility Programs provides the user with 

the tools to maintain and service the system efficiently. The 
functions performed fall into four major categories: data base 
integrity, system and data base backup, system parameter changes, 

and utility subroutines. Data base integrity utilities enable the 
user to validate the structure of his data base(s). System and 

data base backup utilities enable the user to copy disk images and 

to save and restore individual programs and globals. System parameter 
- change utilities allow the user to modify the system configuration 

as required. Utility subroutines are a set of programs which provide 


commonly used operations, such as printing the date and time. 
1.2 SYSTEM HARDWARE 


The MUMPS system is defined within the limits of a particular PDP-1l 
hardware system configuration; 1.e., memory size requirements, 
necessary features, and types and numbers of peripheral devices. The 


1The PAC and UCI codes are assigned by the system manager at System 
Generation time as described in the MUMPS-11 Operator's Gutde. 


system is distributed on magnetic tape (7-track or 9-track), and RKO5 

or RKO6 disks. It requires at least one type of the four disk systems 
available. During system operation, disk, DECtape, magnetic tape, 

Or paper tape is used for backup storage. Figure 1-2 shows the MUMPS 

minimum hardware requirements. 


1.2.1 Minimum Hardware Requirements 


The minimum equipment configuration necessary for MUMPS operation 
includes: 


S PDP-11/10 Central Processing Unit 
e 24K words of Memory 
@ Extended Arithmetic Unit (KE11A or KE11B) or Extended 


Instruction Set for 11/34, 11/40 (KE11E) 

® Real Time Clock (KW11-P or KW11-L) 

© Bulk Storage (ROM) Bootstrap Loader (MR11-DB) 

® Communications Interface (DL11A or KL11A) 
Console Terminal (VT05, VT50, VT52, VT55, LA30, LA36, 
LA180, ASR33, or ASR35) 


® Tapes! 


Magtape Control (TM11) 
Magtape Transport (TU1O or TS03) 7- or 9-track) 


OR 


Magtape Control (TJU16) 
Magtape Transport (TU16) 9-track 


OR 


DECtape Control (TC1l1) 
Dual DECtape Drive (TU56) 


e Disks: 


DECpack Control (RK11) 
DECpack Drive (RK03/RK05J), 1.2 million words 


OR 


Disk Pack Control (RK611) 
‘Disk Pack Drive (RK06), 7 million words 


‘Tape is not necessary if your system includes 2 RKO5 or RKO6 drives. 


i=) 


9-T 


OR CPU 
EIS 


UNIBUS 


ANY ONE OR A COMBINATION OF DISKS * 


RS11 
1-8 disks 


RKQ3 
RKO5 
1-8 disks 


RKO6 


1-8 disks — 


* Due to system restrictions, only one of either the RK611, 
RF11, or RH11 (RSO4) disks can be used. RPO2, 03 disks 
and RP0O4, 05, 06 cannot be combined on the same system. 


EITHER DECTAPE 
MAGTAPE OR BOTH*** 


CONSOLE 


TERMINAL 


TC11 
DECTAPE MAGTAPE 
T T 
| 
| | 
| | 
ee bes 
TUS56 TSO3, TU10 
OR TU16 
RP0O2 
RPO3 


1-8 disks 


RP04 RPO6 
RPO5S 1-4 disks 
1-8 disks 
RS04 
1-8 disks 


** An RPO6G disk counts as 2 RPO4 or RPOS disks in MUMPS. 


*** If 2 RKOS or RKOG drives are used, no magtape or dectape 
is necessary. 


Figure 1-2 MUMPS Minimum Hardware Requirements 


OR 


Disk Pack Control (RP11) 
Disk Pack Drive (RP02 or RP03), 10.24 million words 
or 20.48 million words 
OR 


Disk Pack Control (RH11) 


Disk Pack Drive (RP04, RP0O5) 44 million words 
Disk Pack Drive (RP06), 88 million words. 


1.2.2 Optional Hardware 


The following hardware, in addition to that previously specified, is 
also supported by MUMPS: 


6 Memory: Core, MOS, or Bipolar Memory up to 124K words. 


® Floating Point Processor for 11/45, 11/55, or 11/70 
(FP11-B-or FP11-C). 


® Memory Management Option (KT11 -C or -D). 


e Communications Interface (DLL1-E), connected to a Bell 
System type Dataset (max 1800 baud), 1 per terminal. 


® Communications Controller (DMC-11), direct connection 
from CPU to CPU via a 20 milliamp current loop, or connected 
to one or more synchronous modems. 


@ Terminals (maximum 16 single-line controllers - DL11A or 
DL11C), ASR33 or ASR35 teleprinters, LA30, LA36 DECwriters, 
or VT05, VT50, VT52 and VT55 video terminals. 


® Three multiplexers (DH11-AA or AC), or six multiplexers | 
(DZ11), with a maximum of 16 terminals per DH multiplexer 
or a maximum of 8 terminals per DZ multiplexer (2 DZ1l1's 
are equivalent to 1 DH11; DZ's and DH's may be mixed on 
the same system)!. 


@ High Speed Paper Tape Reader/Punch (PC11).. 


@ Punched Card Reader (CR11) and Mark Sense Card Reader (CMl1l). 
@ Line Printer (LP11), LA180 matrix printer. 
@ DECtape Control (TCll). 


@ Two Dual DECtape Drives (TU56). 


1See Table 3-1 for further information. 


@ Magtape Control (TM11) with up to 4 Magtape Drives (TU1O 
or TS03), 7- or 9-track, or Magtape Control (TJU16) with 
up to 4 Magtape Drives (TU16), 9-track. 


rc) Disk Pack Control (RF11) with up to 8 Disk Pack Drives 
(RS11), 209.72 million words total. 


@ DECpack Control (RK11) with up to 8 DECdisk Drives (RKO5J), 
9.6 million words total. 


@ Disk Pack Control (RK611) with up to 8 Disk Pack Drives 
(RKO6), 56 million words total. 


8 Disk Pack Control (RP11-C) with up to 8 Disk Pack Drives 
(RPO2/RP03), 81.92 million or 163.84 million words total. 


@ Disk Pack Control (RH11) with up to 8 Disk Pack Drives 
(RPO04, RPO5) 351.84 million words total; or up to 4 Disk 
Pack Drives (RP06), 351.84 million words total (1 RP0O6 
is equivalent to 2 RP04's or RP05's; RP04's, 05's, 06's, 
may be mixed in the same system). 


® Disk Pack Control (RH11) with up to 8 Disk Pack Drives 
(RSO04), 419.43 million words total. 


NOTE 


BA-11 Expander Boxes are required to provide 
power to pertpheral devices and a DB-11 Bus 
Repeater ts also needed tf more than 18 loads 
are attached to the UNIBUS. Thts hardware 
presents no addtttonal programming consideratton 
but should be ineluded as required to suit 
spectfie hardware conftguratton,. 


1.2.3 The System Device 


The System Device is the disk memory device on which the MUMPS software re- 
sides. Specifically, the system resides on physical unit 0 of any one 
of the allowable disk systems (see Section 1.2.1). Thus, either RKO, 
RFO, RPO, or RJO can be used. The software occupies up to the first 
50 blocks on the system device, while the remaining portion as well 

as all other disk units in the configuration are used to store MUMPS 


programs and data, including Sequential Disk Processor files. 
1.3 SYSTEM SOFTWARE 


The software which comprises MUMPS consists of the MUMPS Operating 
System and the MUMPS Library and System Utility Programs. 


1.3.1 Operating System 


The Operating System contains all software necessary to operate MUMPS 
in the hardware environment of the PDP-11. The software is entirely 
core resident and consists of the four subsystems described below: 


e Executive - Supervises the timesharing/multipro- 
gramming operations of the system. 


® I/O Monitor - Supervises terminal and peripheral 
device I/O and interrupt processing. 


@ Language = Implements and provides execution con- 
Interpreter trol of MUMPS Language programs. 

® Data Base - Performs all logical and physical con- 
Supervisor trol of the data base. 


The paragraphs which follow describe the operational features of 


each. 


1.3.1.1 Executive - The Executive implements the time-sharing 
aspects of the system and permits partitioned multiprogramming 
using dynamic assignment of user partitions. The Executive is 

used to pass control from one user to another in order to utilize 
the central processor as much as possible. As a result of memory 
partitioning, the Executive can switch from user to user in minimum 


time, 


The Executive uses a set of priority-weighted queues to administer 
its scheduling algorithm including one or more Wait-Queues and a 


Run-Queue. Initially a job starts at the end of the highest 
priority Wait-Queue. Upon reaching the front of this queue, the 


job is placed in the Run-Queue and allowed to execute for the duration 
of its time slice. If the job is processor-bound at the end of its 
time slice, the Executive drops it from the Run-Queue and places it 

at the end of the next lower priority Wait-Queue. When the job 
reaches the front of this queue, the Executive doubles the job's 

time slice and places it in the Run-Queue. If the job remains 
processor-bound, it is placed in the lowest priority Wait-Queue upon 
expiration of its time slice. When it reaches the front of this 
gueue, it is allocated a triple time slice and is placed in the 
Run-Queue. Thereafter the Executive circulates the job between the 


lowest Priority Wait-Queue and the Run-Queue. When the job 
becomes input/output bound, the Executive places the job in an 


'I/O hung’ state to await completion of the requested input/output 
task. Completion of the task causes the Executive to place the 


job at the end of the highest priority Wait-Queue. 


The Executive runs jobs from lower priority Wait-Queues only when 
the higher priority Wait-Queues are empty. This technique pro- 
duces the most favorable response time for the interactive parts 
of any job by servicing input/output bound tasks very quickly but 


taking longer to service CPU-bound tasks. 


1.3.1.2 Input/Output Monitor - Once a job becomes input/output 
bound, the Executive places the job in the appropriate 'hung' state 
and the Input/Output Monitor initiates and processes the input/output 
activity through its interrupt handlers. The MUMPS Interpreter and 
the I/O Monitor communicate through buffers for terminal input/ 
output character processing, but the I/O Monitor supervises the 
asynchronous filling and emptying of these buffers so as to over- 
lap output with that program's processing whenever possible. 

The Input/Output Monitor creates a terminal-independent environment 
in which an application program can run with any terminal of the 
hardware system regardless of its specific speed and formatting 
characteristics. At terminal log-in, a partition initially ‘owns' 
one terminal; it may subsequently acquire other terminals in the 
system or it may release the original terminal and continue as a 


background job. 


The I/O Monitor also supervises the peripheral input/output devices 
of the system, including the magtape and DECtape drives, the paper 


tape reader-punch, line printer, etc. 


1.3.1.3 Log-in Processing and the Language Interpreter - During 
terminal log-in, a user is assigned an available partition. User 
Class Identifier codes and the Programmer Access Code are checked 

for validity, resulting in either authorization or denial of access 
to associated programs and global files. Since terminal programming 
of application packages is allowed, stringent checks are performed 

by the Interpreter to safeguard the system's service operations 

from all programming activities. If the user intends to program, 

his partition is initialized and control is passed to the Interpreter 
for the subsequent programming session. If the user desires activa- 


tion of a service program, the requested program is loaded from the 
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disk into his partition and execution of that program commences. In 
either case, the user retains his partition until he logs-off the 


system. 


All application programs are written in the MUMPS language. This 
language allows an application programmer to write a program and 
debug, edit, run, and modify it in a single interactive session at 
a terminal. This minimizes the programmer's time in solving a 
problem, the computer time needed in checking it out, and, most 
important, the elapsed time required to obtain a final running 
application program. The Interpreter itself is an integral part of 
the system. The Executive and I/O Monitor have been specifically 
tailored to work efficiently with the Interpreter. 


The Interpreter examines and analyzes all MUMPS Language statements, 
executing, in turn, the desired operations. Each MUMPS Language 
statement undergoes identical processing each time it is examined 
(executed) by the Interpreter; intermediate code is not generated. 
Comprehensive error checking is also performed to assure proper 


language syntax. 


In addition, the Interpreter also files and loads programs via the 
disk storage system. During program execution, it automatically 
overlays external program segments invoked by an active program. 
Proper linkages are set up to return to the invoking program when 


execution of the segments terminates. 


A number of major advantages are obtained from the use of the Inter- 
preter as the major components of the MUMPS system. First, programs 
written in an interpretive language do not require any compiling or 
assembling. Error comments during execution are printed at the pro- 
grammer's terminal and allow quick recovery, modification of the pro- 
gram, and re-execution of it. All program debugging and modification 
operations are performed in the MUMPS language directly at the terminal. 
This makes modification convenient, particularly in a service environ- 
ment where the trouble-shooting necessary to interface a program with 
an application area is a time-consuming process. The MUMPS environment 
allows a programming session to take the form of a conversational 


dialogue between the programmer and the terminal device. 


1.3.1.4 Data Base Supervisor - The Data Base Supervisor consists of a 
group of routines which provide physical as well as logical control of 


the various disk systems which form the data base. 


oe 


In MUMPS, all file information is referenced symbolically, in the con- 
text of hierarchical global variables and arrays. This replaces the 
classical manner of sequentially accessing record files on secondary 
memory devices. Instead, an attempt is made to logically map the 
content and structure of the tree-like symbol tables into the physical 
storage medium of the system. The Data Base Supervisor maps logical 
information at a specific level of an array into directories of fixed 
size blocks. These blocks are chained together in a linear fashion to 
contain all the data values stored at that specific level, as well: as 
the pointer words which link it to chains of the next lower level. 

The data base devices used in the system are some combination of fixed 
head disks and/or moveable head disk packs. The organization of either 
an individual platter of the fixed head disk or a cylinder of the 
moveable head disk pack is two-dimensional, wherein any physical 

block has a track and segment coordinate. 


Maps of addresses of unused disk blocks (storage allocation maps) ! 

are maintained to facilitate the dynamic allocation of disk storage 
space to files. Whenever a continuation or a header block is to be 
allocated, a block in the map, whose segment address is a few segments 
away, is utilized. This method ensures that the time required to 
retrieve a particular datum is kept to a minimum. When data is up- 
dated, care is given to repacking, and sometimes reorganizing the 
individual data elements within a chain, to ensure maximum utilization 


of space for variable length data. 


Once a block of data accommodating a given level of subscripting is 
referenced, its address is placed in the partition's overhead area 
and the block remains in memory until a reference to a different 
block is made. This permits considerable time savings when the 


"naked' syntax is used in referencing globals*. 


When a level is reached, often no further disk access need be made to 
reference associated information. If any block in a disk is altered, 
it is written back on the disk. | 


When a part of a global structure is deleted, it is attached toa 
"Garbage Chain'. The Garbage Collector routine removes blocks from 
the tree-like chain and refills the Storage Allocation Maps with the 


IThe Storage Allocation Maps are bit maps where there is a correspon- 
dence between map address and bit position within the map, and the 
disk address of the block. 

“Appendix G provides a detailed description of the structure of 
global data. 
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addresses of the expunged blocks. This is done during periods of low 
CPU activity to avoid competition with active programs. 


1.3.2 Utility Programs 


The MUMPS Utility Programs are a package of programs written in the 
MUMPS Language which are supplied as a part of the MUMPS software 
package. These programs are provided to assist both the MUMPS 

System Programmer and the MUMPS System Manager in developing and 
maintaining the software and data for their particular application. 
The Utility Programs consist of two functionally distinct groups: 
System Utility Programs and Library Utility Programs. The System 
Utility Programs provide functions for use by the System Manager; 

they reside on the disk under the control of the system UCI (UCI #1) 
and are accessible only to those individuals possessing the System 
UCI Code. Library Utility Programs provide general services which 
are available to all system users, regardless of UCI". These programs 
also reside under UCI #1 but employ a naming convention which 
distinguishes them from System Utilities. The main difference 
between the System Utilities and the Library Utilities is that only 
users logged-in under the System UCI code (UCI #1) may use the former, 
while all users, regardless of their UCI codes, may use the latter. 
Tables 1-1 and 1-2 briefly describe the MUMPS-11 Utility Programs. 
Further information about Library Utilities is provided in Chapter 4. 
The MUMPS-11 Operator's Guide describes the System Utilities. 


‘The Global Place Program (%GP) is an exception to this rule. 
Though functionally a system utility, it resides in the system 
as a library utility because of the nature of its operation. 

GP is documented in Chapter 4 of the MUMPS-11 Operator's Guide. 
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Table 1-1 
System Utility Program Summary 


Name Description : | 


Broadcast Program 
Allows the operator to send messages to all or 
specified terminals. 


System Caretaker Program 
Collects system error statistics. 


Date Routine (or Date Set) | 
Sets the SD system variable to the current date. 


Disk Block Tally Program 

Calculates the number of disk blocks available for 
each disk (logical and physical), updates Disk Stor- 
age Allocation Table, tallies and reports errors. 


Disk Block Dump Program 
Lists the contents of disk blocks or gives an 
analysis report of the system's crash block. 


Caretaker Reporter Program 
Lists error statistics collected by the caretaker. 


Modify System Parameters Program 

Alters UCI codes, terminal types, number and 
size of partitions, Programming Access Code, 
Magtape default mode. 


RK Copy ee | 
Used in RKO5 distribution to physically copy one 
RKO5 to another. 


Restore Job 
Allows jobs that are either in a wait queue or in an 
I/O hung state to be restored to the system. 


Restore Devices 
Releases devices either owned by a job or disabled 
by a syste: crash. 


Sequential Disk Processor 
Space Allocation/Deallocation Program. 


Status Information Program 

Provides system status information 

(calls the SS program) and system partition size 
assignments. 


System Status Program 

Provides information about the current users (UCI's) 
in the system, the status of their jobs, and utiliza- 
tion of system resources. 


System Shutdown 
Gives instructions to the operator on how and when 
to "HALT" the system. 


Continued on next page 


Table 1-1 (Cont.) 
System Utility Program Summary 


Name Description 


System Startup 
Initializes the system when disk bootstrap 
loading is performed. 


SYSGEN System Generator Program 
Tailors the basic MUMPS Operating System for 
specific hardware configuration. 


Time Routine 
Sets the $T System Variable to the current time. 


System Test Package 
Provides basic test programs to help verify 
that a MUMPS system is operational. 


Global Place 
Allows the system user to position global files on 
a specific unit and cylinder of a disk drive. 


Table 1-2 


Library Utility Program Summary 


Date subroutine 
Reports the current (system maintained) date 
on the specified I/O device. 


Fast Program Directory Lister 
An abbreviated high-speed version of $%PD, 
$#D lists only program names. 


Global Directory | 
Lists the names of all globals of the current 
UCI onto the designated output device. 


Global Lister 
Lists the structure and content of a specified 
global file on the designated I/O device. 


Global File Restore 

Restores all or specified Global Files onto the 
data base, entering their names in the Global 
Directory of the current UCI. 


Global File Save 

Copies all or specified global files listed in 
the global directory or the current UCI onto 
the designated output device. 


Global Trace Program 


Lists global nodes, their location, level, data type 
and contents for the current UCI. 
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Table 1-2 (Cont.) 


Library Utility Program Summary 


Global Utilization Program 

Analyzes a global, giving the number of nodes, 
total bytes, bytes/block and % utilization for 
each data type, for system overhead and for each 
free area in a global. 


Global View Program 

Dumps a global disk block as seen by the system; 
prints subscript, pointer, data type and data 
for each node. 


I/O Device Assignment Subroutine 
Assigns specified I/O device if available and 
informs the calling program of result. 


In Use Message Program 
Displays the message "IN USE" on the currently 
assigned device. 


Oétal/Decimal Conversion Program 
Converts octal or decimal values to their decimal or 
octal equivalents. 


User to Operator Communication Program 
Allows a terminal user to send messages 
to the console terminal. 


Program Directory Lister 

Lists the contents of the Program Directory, 

the starting disk block number, and the length 
of each program of the current UCI on the desig- 
nated I/O device. 


Program Load 

Loads programs reSiding on paver tape, DECtape, 
or magtape, which were saved via %PS, onto the 
disk, and enters their names in the Program 
Directory of the current UCI. 


Program Save 

Copies specified programs listed in the Program 
Directory of the current UCI onto the designated 
output device. 


Time Subroutine 
Reports the current (system maintained) time 
on the specified I/O device. 


CHAPTER 2 
USING THE TERMINAL 


2.1 INTRODUCTION 


MUMPS terminals are not only data input and output devices to be 
used with application programs, they are also the means by which 


MUMPS programs are created and executed. 


This chapter describes how to use MUMPS 11 terminals for developing 
MUMPS application programs. In particular, the chapter describes 
how to: log-in and log-out; enter commands; correct typing errors; 
and store, load, and modify programs. The last section of this 


chapter describes MUMPS error processing. 
Operating at a terminal, the programmer can: 


Execute MUMPS commands immediately; 
Input the steps of a program; 


Run programs and access global files listed in the 
directories of the current UCI; 


e Run Library Utility Programs!?. 
2.2 TERMINAL TYPES 


There are many types of terminals used in MUMPS systems, but most 
have typewriter-like keyboards that do not vary significantly from 
one to another. The main differences between terminals are: choice 
of hard or soft copy, speed of operation, and the location of special 


control characters on the keyboard. 


As described in Chapter 1, individuals who are permitted to run 
MUMPS programs are given an appropriate UCI code. With this code, 
they can run any program in the UCI's program directory. They can 
not, however, modify or create programs: a UCI alone does not allow 
access to Direct Mode. The system's Programmer Access Code (PAC) 
permits entry into Direct Mode through which programs can be created 


and modified and individual MUMPS commands can be executed. 


1Library Utility Programs are described in Chapter 4. 


2.3 PRELIMINARY OPERATIONS 


Before attempting to log-in, the user should make sure that the 


power on his terminal is turned ON and the terminal is ON-LINE. The 
procedure varies from terminal to terminal, but for Teletypes and ~~ 


DEC-manufactured terminals it is as follows: 


® Teletypes - Turn the LINE-OFF-LOCAL switch to 
LINE. The teleprinter's motor 
should start. 


e LA30 DECwriter - Set the circuit breaker on the 
left of the back panel to ON. The 
motor should start and the READY light 
should be lit. | 


e LA36 DECwriter II - Operate the switches at the left 
side of the keyboard as follows: 


POWER ON/OFF to ON 

LINE/LOCAL to LINE 

BAUD RATE to match the applicable 
baud rate of the hardware controller. 


@ VT05 Video Terminal - Set the ON-OFF switch on 
the right side of the keyboard to ON; 
then set the LOC/REM switch to REM. 
The blinking cursor should appear on 
the screen after a few moments. 


@ VT50, VT52, and VT55 Terminals - Set the POWER ON/OFF 
, switch located in the recessed portion 
of the right side of the cover to ON. 
Set switches Sl and S2 to match the 
applicable baud rate of the hardware 
controller as shown in Table 2-1. 


Table 2-1 
VT50 Baud Rate Switch Settings 


Baud Rate 
Mode Transmit Receive Switch Sl1* Switch S2** 


Local 


Full Duplex with 
Local Copy 


Full Duplex 


PUOPrPraQnroAya |~wWnowhAa jWBnoeya 


Full Duplex 
(Split Speeds) 


DUPAMNEHDUTEHDUAE HAUS 
QQQTVVTV AAA DM?AWAAAN 


*Switch Sl Labels *kGwitch S2 Labels 


l = Local A = Bell System type 103 dataset 
2= 1/2 B = 110 Baud 
3 = Full Duplex C = 600 Baud 
4 = 300 Baud D = 1200 Baud 
5 = 150 Baud E = 2400 Baud 
6 = 75 Baud F = 4800 Baud 
G = 9600 Baud 


2.4 SPECIAL KEYBOARD CONTROL CHARACTERS 


The following control characters have special significance to MUMPS 
terminals. CTRL characters are formed by depressing the CTRL key 
while striking the associated character key as with CTRL/C and 
CTRL/U. 


® BREAK and CTRL/C - The BREAK button on the Teletype 
and the CTRL/C function on all terminals are used 
interchangeably to request use of a terminal or to 
attempt to interrupt the current operation. The 
use of BREAK and CTRL/C as interrupting characters 
is discussed under the ASSIGN command in the MUMPS-11 
Language Reference Manual and in paragraph 2.5 of 
this manual. 


e Carriage RETURN/ALT MODE/ESC - These characters are used 
interchangeably as line terminators for terminal input. 
They are represented internally by the NUL (@@@) ASCII 
code. Note that this usage of ESC is different from that 
for the VT52 (described in Section 3.7.1.4). 


@ RUBOUT - Deletes single characters in the current line 
starting with the rightmost character. Each time the 
key is depressed one character is deleted and a 
backslash (\) is echoed. (A RUBOUT on VTO5 erases 
the last character typed.) This command is effective 
only if a line terminator has not been typed for the 
line in question. 


Examples, 

ee 5. "PORT SOCKE 
Given that the final 'E' has just been typed, the 
above misspelling can be corrected by typing seven 


RUBOUTs followed by the correct letter sequence. 


1.25 T "FORESOCRE\\\\\\\URSCORE 


® CTRL/U - Deletes the entire line. Like RUBOUT, 
CTRL/U works only on lines which have not been 
terminated. Thus, typing CTRL/U rather than 
RUBOUT in the previous example would delete the 
whole line. MUMPS echoes 1tU followed by a 
Carriage RETURN/LINE FEED. 


@ CTRL/O - Suppresses terminal output printing. Typing 
CTRL/O again restores output printing if there is 
any more output to the terminal. The system auto- 
matically restores output printing when: returning 
to Direct Mode; the terminal is ASSIGNed; an error 
occurs; or a BREAK or CTRL/C is received and the 
terminal is unowned. 


2.5 LOGGING-IN TO THE SYSTEM 


Each user of a MUMPS terminal gains access to the system's programs 
using a special log-in sequence which involves one or two access 
codes (depending on the privileges allowed the user). These codes, 
provided by the MUMPS System Manager, are the User Class Identifier 
code or UCI, and the Programmer Access Code, or PAC. The MUMPS-11l 
System can have up to sixteen UCI's (classes of users). The UCI 

code must be entered by all terminal users. It allows access to 

the programs and globals listed in the Program and Global Directories 
assigned to that UCI. A user who is permitted simply to run programs 
needs to know only the UCI code and the names of those programs which 
he is permitted to use. Users who are allowed to create or modify 
programs and global files must know the system's PAC. This code 
permits system operation in Direct Mode whereby a programmer can 
execute MUMPS commands at the keyboard, as well as create, modify, 
and delete global data and programs associated with a specified 

UCI. The following procedures describe the steps to be used for 


system log-in: 


a. Type either CTRL/C or BREAK. MUMPS will respond with 
MUMPS-11 Vnn nn 


where: vnn 
nn 


verston of system 
terminal's devtce number 


On the next line, MUMPS types 


UCI: 


b. The terminal user should respond in one of two ways. 
If a UCI.and a program name are specified, that program 
will be loaded and started upon a successful log-in. 
If a UCI and the PAC are specified, MUMPS will enter 
Direct Mode. The response must be in the following 
form: | 


prog 


ucl: 


where: uet = the user's UCI code 
= delimiter 


pae = the Programmer Access Code (PAC) 


prog = the name of a program to be run 
restding tn the Program Dtrectory 
of the UCT. 


If the user does not respond within 20 seconds, he is 
automatically logged-out and must again type CTRL/C 
Or BREAK to reinitiate the log-in sequence. 


c. After the codes have been typed, depress either Car- 
riage RETURN or ALT MODE. If the codes are legitimate, 
MUMPS will either run the requested program, if a. pro- 
gram name was specified, or type the right angle bracket 
(>) prompting symbol to signify its readiness to accept 
commands in Direct Mode, if the PAC was specified. 


d. If log-in was not successful, an error message is 
printed and the terminal is logged-out. 


The following are examples of system log-in sequences (user 
responses. underlined) : 


a. Log-in to Run a Program (Indirect Mode operation only) 


CTRL/C 

MUMPS -11 V3B #6 

UCT: NAMsS2T Enter UCI and program name 
18:38AM Program runs to completton 
EXIT User ts logged-out 


b. Log-in to Create, Modify and Run Programs (Direct or 
Indirect Mode Operation) 


CTRL/C 

MUMPS-11 V3B #6 

UCI: SAM:QYV Enter UCI and PAC 

> User ts given control tn Direct Mode 
: User performs destred tasks 

>HALT Log-out 


2.6 LOGGING-OUT OF THE SYSTEM 


When the user wishes to end his session at the terminal, one of 


the following procedures can be used. 


a. If a program is running (1i.e., Indirect Mode is in 
effect), type a CTRL C or a BREAK. 


If the user did not log-in with the PAC and program 
interrupt is enabled!, the message "EXIT" is printed 
and the terminal is logged off automatically. If pro- 
gram interrupt is not enabled, the job may determine 
the action to be taken.* If the user had logged-in 
with the PAC, control is returned to Direct Mode and 
a '>' is printed. 


b. If the user is operating in Direct Mode, log-out is 
accomplished simply by typing: 


>HALT 


immediately after the '>' character. The "EXIT" mes- 
sage is printed and the terminal is logged off. 


2.7 ENTERING COMMANDS 


Once a terminal user has logged-in to the MUMPS system using the 
Programming Access Code, almost any MUMPS Command or Function can 
be executed from the keyboard in Direct Mode. Exceptions are: 
OVERLAY, BREAK, ELSE, and GOTO. 


1See ASSIGN Command in the MUMPS-11 Language Reference Manual. 
*See paragraph 5.2 on the $J System Variable. 


2.8 SUMMARY OF COMMAND AND FUNCTION SYNTAX RULES 


The following is a list of the rules of syntax as presented in the 


MUMPS Ldnguage Reference Manual. 


® Commands which are to be executed immediately 
(Direct Mode) do not use Step Numbers. The 
first character of the command is the first 
character on the line. 


@ Commands which are to be executed as part of a stored 
program (Indirect Mode) are preceded by a Step Number. 
The first command on a line is separated from the 
Step Number by a Single space. 


® Each command may be abbreviated to its first letter 
(first letter after the 'S$' for a function). Fur- 
thermore, to do so saves partition space since 
only the first character is necessary, but all suc- 
ceeding characters up to the next space char- 
acter are stored. Care should be used when abbre- 
viating commands to avoid confusing certain commands 
which are executable only in Direct Mode with others 
which can be executed only in Indirect Mode. 


Example: 
Fuu2.5 
In Direct Mode, it means: 'ERASE Step 2.5'. But: 
in Indirect Mode, it is read as: 'ELSE' and pro- 
duces a SYNTX error, since 2.5 is not a valid com- 
mand. 
@ A command is separated from its argument or argument 


list by a single space. 


@ Multiple arguments to a command or function are 
separated from each other by Single commas. 


® Multiple commands on the same line are separated 
by Single spaces. 


@ Certain commands permit the use of an argument or 
argument list to be optional. If such a command is 
to be used with no argument list and it is not the 
last command on the line, it must be separated from 
the next command by two spaces. If there are no 
commands following it on the line, the spaces must 
be omitted. Note that the ELSE command is an excep- 
tion; only one space is allowed. 


® Program comments may be added to any command line. 
When comments are used, they must begin with a semi- 
colon (;). The semicolon must be separated from the 
preceding command argument list or Step Number by a 
space. 
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The indirection syntax operator, symbolized by 
underscore (__) or back arrow (+), provides 
dynamic command argument definition. In form, 
the command argument is replaced by a variable 
name. During execution, the contents of that 
variable name are taken as the argument. 


Example: 


where: A=1, B=2 and C=3 
ARG = "B+C-A"™ 


>TYPE: «ARG 
4 


> 


An optional Boolean-valued expression preceded by a colon 
(:bve) can be used to specify conditional execution of 
certain commands and command arguments (see Appendix D). 


Examples: 


2.93 GOTO 3:A>R 


Control ts transferred to Part 3 tf the contents 
of 'A' ts greater than the contents of 'B', 


19.21 WsA=B 2 


If A=B, all the steps tn part 2 are wrttten out 
to the currently assigned I/0 device. 


The colon is also used as a field delimiter in the 
arguments of FOR, MODIFY and ASSIGN commands. 


Example: 
1.@9 F I=lsl:1@ D X 


The colon can also be used to indicate the presence of 
an optional expression appended to some command arguments. 


Example: 
6.50 READ x35 ts a 'ttmed'’ Read. 


Function arguments are enclosed in parentheses 
and immediately follow the function name. 


Functions which produce string valued results 
may WOT be nested. Further, where the argument 
to any function is required to be a string, it 
must be in the form of a string variable or 
literal (svl). 


2.9 SUMMARY OF RULES FOR EVALUATION 
The following is a summary of the rules for expression evaluation: 


e Sequence of operations in an expression is strictly 
from left to right, except that a unary minus is 
evaluated before a Boolean NOT when they appear as 
adjacent operators. Parentheses can be used to 
cause operations to be evaluated in a different order 
than would be allowed by the normal sequence of 
operations. 


® Expression elements are variables (global, local, and system), 
literals, constants, functions, and subexpressions 
(expressions enclosed in parentheses). 


@ Automatic data mode conversion is employed to 
convert a string datum to numeric datum and vice 
versa aS required to complete any particular 
operation. | 


2-10 CREATING PROGRAMS 


To create a program, the terminal user logged in under a PAC simply 
enters a Step Number at the beginning of a command line. This signals 
the system to store the line in the program buffer of the user's 


partition rather than to execute it immediately. 
Example: 

>1.05 TYPE 14+(2*3)-(€5/18) 
The programmer may type in as many program Steps as the size of 
his partition will permit. If too many Steps are input, however, 
a PGMOV error will occur. The $S System Variable can be interro- 


gated to determine the number of characters (bytes) of storage 


remaining in the partition. 


Example: 


44 4455 characters of sterage remain 


2.11 STORING PROGRAMS 
There are several choices available to a programmer who wishes to store 
a program within a user partition: 

e The program can be stored on the disk. 


e The program can be stored on a secondary storage 
device such as magtape, DECtape, or paper tape. 


To store a program on the disk, use the ‘'FILE,,pnam' command (pnam 


is a MUMPS identifier with a 3-character limit) . 
Example: 


>F_ ASC files the program called 'A3C' and 
places tts name tn the Program Dt- 
reetory of the current UCT. 


There is also an argumentless FILE command, which assumes the current 


program name. 


The ASSIGN and WRITE commands are used to save a program on a sec- 


ondary storage device. 


For example, the following command line writes. the program currently 
in the user's partition onto DECtape unit 1, starting at address 2,569: 


>A 56:2567 WU 56 


Note that the UNASSIGN is necessary to write the last buffer onto 


the DECtape, as well as to free the device for other users. 
2.12 LOADING PROGRAMS 


There are several ways to load programs. The techniques are just 
the reverse of those used to store programs, with the following 
addition. If the programmer merely wishes to run a program re- 
Siding on the disk, loading can be effected by logging-in with the 


program name. 


For example: to run the program 'B23' which is entered in the 
Program Directory of UCI 'BOB', log-in as follows: 


CTRL/C 
MUMPS-11 V3B #6 
UCI: BOB: B23 


: Program B23 runs to completton, 
; then exite. 
EXIT 


If the programmer wishes to make alterations to a program, continue 
development, fix bugs, etc., he may load the program in one of the 
following ways using the LOAD command. 


If the program 'A3C' is listed in the Program Direc- 
tory of the current UCI, 


>LOAD A3C 
brings the program into the partition's program buffer. 


The CALL command may also be used for disk-stored programs, 
however it causes automatic program execution. 


If the program to be loaded is on a secondary storage 
device, the LOAD command without the program name 
argument will load a program from the currently ASSIGNed 
I/O device. 


The following example loads a program from the Paper 
Tape Reader (device 2): 


>A 2 LOAD U2 


Note that a LOAD of this form merges the program being 
loaded with the program, if any, currently in the par- 
tition. Steps of the program being loaded replace Steps 
of the same number currently in the partition. If a merge 
is not desired, ERASE should be issued before the LOAD, as: 


ae A OO 


2.13 STARTING AND STOPPING A PROGRAM 


The DO command can be used to start a program currently residing 
in the user's partition. The programmer can specify an entire 


Part: 


or individual Steps or groups of Steps: 


>D 3.32 
>D 6.10,4,1.83 


The entire Part, Step, or group of Steps will be executed and con- 


trol then returned to the programmer at the terminal. 


NOTE 
A DO command does not effeet complete 
executton of a program having more than 
one Part unless a GOTO command ts also 


used within each Part to effect trans- 
fer of control from one Part to the next. 


Programs are normally stopped by: 


® Executing a HALT; 


@ Executing a QUIT at the lowest (outermost) pro- 
gram nesting level; 


@ Running out of Step Numbers in the current Part 
or reaching the end of a Step if 'DOing' a Step; 


© Typing a BREAK or CTRL/C from the Principal I/O 
Device if CTRL C/BREAK recognition is enabled. 


2.14 CHANGING, REFILING, AND DELETING PROGRAMS 


Program creation takes place in Direct Mode. Once a program is 


resident in the user's partition, the programmer can: 
® Add new Steps by typing them in; 


® Replace existing Steps by entering a Step with the 
same number; 


2-13 


e Delete one or more Steps using the ERASE command; 
@ Modify Steps using the MODIFY command; 


e Print out the entire program or parts thereof 
using the WRITE command. 


e Modify the Program through use of the Editor (cf. 
Section 4.3). 


After a program has been FILEd it remains in the partition until: 
it is ERASEd, the session at the terminal is HALTed, or another 
program is loaded from the disk. The programmer can continue to 
run, modify, and refile it. 


Each time a FILE command is executed, the program currently present 


in the partition replaces any program previously FILEd having the 
same name. | 


Deleting a FILEd program is accomplished by FILing an empty Program 
Buffer. Simply issue an ERASE Command followed by a 'FILE pnam' 
Command (where pnam is the name of the program to be deleted). 

This will remove the program from the disk and delete that program's 
name from the current UCI's Program Directory. 


Example: 
To delete program 'JOE', type: 
>E  F JOE 


Changing a program's name involves a like procedure. First LOAD the 
program which is to have its name changed. Then FILE it using the 
new name, Last, delete the old program by issuing an ERASE followed 
by a FILE using the old program name. To keep several versions of 


a program, give each one a different name. 


2-15 ERROR PROCESSING 
The standard MUMPS error processing procedure considers all language 


syntax, program or system operation errors fatal. MUMPS normally 


reports errors by: 
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e setting the $I System Variable to the Principal I/oO 
device number (the device at which the user logged-in) 


printing an appropriate message on the Principal I/O Device 


halting the program 


If the user logged-in under a PAC, control returns to the user in Direct 
Mode. If the user logged-in simply to run a program, the user is 
automatically logged-out. Appendix C describes the MUMPS error 


messages. 


The user may write an application program which performs its own error 
processing and avoids interrupting the job with a fatal error, by 
using the SE System Variable. Refer to Paragraph 5.3 for further 


information. 


CHAPTER 3 
USING I/O DEVICES 


3.1 INTRODUCTION 


MUMPS timesharing allows multiple users to have access to the same 
central processor via separate remote terminals. It also allows 

one user to have access to many terminals from one program. In 
addition to terminals, MUMPS systems also include ancillary Input/ 
Output devices such as the high-speed paper tape reader and punch 
and DECtape transports. Each I/O device has a unique identification 


number within the system. 


"Ownership' of a device is established by using the ASSIGN Command. 
In a timesharing environment, many programs may be competing for 

the use of a single device. Thus, before attempting input or out- 
put to a device other than the terminal with which the program is 


associated, an ASSIGN command must be issued. 


Once ownership of a device is established, I/O may proceed using 
the I/O commands available. In general, the programmer need not 

be concerned with specific characteristics of MUMPS I/O devices 
Since data transfers consist of ASCII lines of not more than 132 
characters. There are, however, certain physical operating charac- 
teristics of these devices which may be of interest to the program- 
mer: for example, how to rewind a magtape or access a particular 
location on DECtape. These characteristics are discussed in later 


paragraphs. 


When an I/O device is no longer needed, it should be released for 
use by other programs by means of the UNASSIGN Command. 


3.2 I/O DEVICE NUMBERS 


The unique identification number of each MUMPS I/O device always 
represents the same device regardless of the hardware configuration 
of a particular system. For example, the line printer is always 
Device Number 3. If a particular system does not have a line printer, 
then Device Number 3 is nonexistent and any attempt to use (ASSIGN) 


it results in a 'NODEV' error message. The system reports a 'NoOTSY' 
error when the user references a device for which there is no associ- 
ated driver in the system. For example, a reference to device number 


55 in a system not built for DECtape I/O causes a NOTSY error. 


Table 3-1 shows the complete list of MUMPS-11 I/O device assignments. 
Note that device numbers 20 through 45 are specified as Program Inter- 
locks. There are no physical devices associated with these numbers; 
instead, they are to be used for inter-program communication. Through 
the use of the ASSIGN and UNASSIGN commands, MUMPS application programs 
can Signal one another. The significance of any particular interlock 
being 'owned' by any particular program is, of course, established by 
user's conventions (i.e., assignment of these "'dummy' devices has no 
particular significance to the MUMPS operating system). Typically, 


one Program Interlock would be associated with each UCI. 
3.3 ASSIGNING I/O DEVICES 


In all MUMPS programs, input and output operations are directed to the 
I/O device whose number is contained in the $I system Variable. When 
the user logs-in to the system, $I contains the terminal's Device 
Number. All error messages are directed to this device, unless the 
program controls its own error procesSing in another manner. Standard 
error processing resets $I to the principal I/O Device. Thus, the 
terminal at which a user signs in is called his Principal I/O Device. 


Ownership of each device which a program is to use, other than the 
Principal I/O Device, must be established by the use of the ASSIGN 
Command. This command permits a program to reserve any number of 

I/O devices. Further, the command causes the last device number 
specified in its argument string to be the ‘current device’ by setting 
the $I System Variable to that device number. 


Thus: 


>A 35,4,5 reserves devices 8, 4, and & 
and makes devtce & eurrent. 


The device being current simply means that, in addition to be being 
owned, its identification number is stored in the SI System Variable. 
This $I may be referenced in any expression but can only be changed by 
ASSIGN. Each I/O Command is directed to the device whose number is 
in $I. A program may not communicate with more than one device at a 


time. 


Table 3-1 


MUMPS I/O Device Table 


1 Console Terminal 

2 Paper Tape Reader/Punch 
3 Line Printer 

4 Terminal #1 (Single line) 
5 Terminal #2 

6 Terminal #3 

7 Terminal #4 

8 Terminal #5 

9 Terminal #6 

10 Terminal #7 

11 Terminal #8 

12 Terminal #9 

13 Terminal #10 

14 Terminal #11 

15 Terminal #12 

16 Terminal #13 

17 Terminal #14 

18 Terminal #15 

19 Terminal #16 

20 Program Interlock #1 

45 Program Interlock #26 

46 VIEW Command 'Device' (memory only) 

47 Magtape Drive #9 

48 Magtape Drive #1 

49 Magtape Drive #2 

50 Magtape Drive #3 

51 Reserved Device #9 

52 Reserved Device #1 

53 Reserved Device #2 

54 Reserved Device #3 

55 DECtape Drive #9 

56 DECtape Drive #1 

a1 DECtape Drive #2 

58 DECtape Drive #3 

59 Sequential Disk Processor #9 

60 Sequential Disk Processor #1 

61 Sequential Disk Processor #2 

62 Cequential Disk Processor #3 

63 VIEW Command ‘'Device' 

64 DH Multiplexer #1, Term. #1 or: 2 DZ mult.* 
‘ ‘ (device #1 and 
< : #2) with 8 
‘ : terminals on 

79 DH Multiplexer #1, Term. #16/ each = 16 

80 DH Multiplexer #2, Term. #1 or: 2 more DZ 
° - mult.* (device. 
; ‘ | #3 and #4) with 
° 8 terminals on 

95 DH Multiplexer #2, Term. #16/ each = 16 © 

96 DH Multiplexer #3, Term. #1 or: 2 more DZ 
. . mult.* (device 
. ‘ #5 and #6) with 
° : > 8 terminals on 

lil {DH Multiplexer #3, Term. #16/ each = 16 


*Device number assignments are based on the assumption that DH and DZ 
multiplexers are not combined in one system. If they are combined, 
DH multiplexers get the lowest device number assignments. 
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Table 3-1 (Cont.) 


MUMPS I/0 Device Table 


Device 


In core job communication, 
transmitter for Unit 0, 
In core job communication, 
receiver for Unit 0 


In core job communication, 
receiver for Unit 7 


When the terminal user or program issues an ASSIGN @ command, I/O is 
directed to the Principal I/O Device. When MUMPS detects a program 
error and the user has not set the SE System Variable, the value of SI 


is changed to the Principal I/O device number so that error messages 


can be output to the terminal at which the user logged-in. 


When a device is no longer required by a program, the UNASSIGN command 
Should be used to release it for use by other programs. This command 
performs the reverse operation of ASSIGN. Each device specified is 
released and the value of the $I System Variable is changed to that of 
the Principal Device. However, in the case of multiple device ASSIGN- 
ments, UNASSIGNing a device does not automatically change the value of 


SI to that of the Principal Device. For example: 


Aum 5,3 oes U oe 5 oe T oe HI" 


sends "Hi" to the printer. 


In the case of output devices, the command is not honored until the 
current output operation has terminated. Also, when a program is 
HALTed, or the user at the terminal ends a session, all currently 
owned devices are automatically UNASSIGNed. 


3.4 I/O COMMANDS 


The commands which effect input and output operations to the terminals 
and ancillary devices are: TYPE, READ, PRINT, WRITE, and LOAD. These 
commands may be used freely with any device except for illegal opera- 


tions such as trying to READ from a Line Printer. 


The TYPE command is used to. output both local and global data, as 


well as literals, constants, and format control characters. The READ 


ever! 


command is used to input data into local variables as well as to out- 
put text literals and format control characters. Programs can be 
Saved and restored by the WRITE and LOAD commands, respectively. 
WRITE causes the program currently in the partition to be output to 
the device specified in the last ASSIGN command. LOAD reads the pro- 


gram residing on the current I/O device into the partition. 


The PRINT command is used primarily to take advantage of special 
features of certain I/O devices, which are specified, generally, 
by non-printing ASCII codes. The PRINT command accepts numeric 
arguments, the low-order seven bits of which are taken as the 
decimal representation of an ASCII code. The code is transmitted 


without conversion to the currently assigned I/O device. Examples: 


a. to ring the bell on a teleprinter, type: 
>PRINT 7 

b. to output a LINE FEED without a Carriage RETURN, type: 
>PRINT 12 

Cc. to rewind Magtape, type: 


>A 47 PS 


Refer to paragraph 3.7.1.4 for the special PRINT command ASCII 
codes. 


3.5 OUTPUT FORMATTING 


Three facilities in MUMPS provide for the formatting of output data. 
These are the form control characters, the ASSIGN command and the 
$X and SY System Variables. 


3.5.1 Form, Control Characters 


Three special form control characters can be used as arguments to 
the TYPE, READ, and PRINT commands: 


# Page Feed (FORM Feed) 
! Carriage RETURN/LINE FEED sequence (line 
terminator) 
?nve Horizontal TABulation - positions the PRINT 
mechanism 'nve' spaces from the absolute left 
margin. 


When the characters immediately follow one another in an argument 
list, no intervening commas are necessary (i.e., #!?3 [!!! or + # 


is legal) 3-5 


Examples: 


>TYPE ##765,"PAGE ",PAG,! outputs two FORM FEEDs followed by: 
65 spaces, the string PAGE, the 
value of the vartable PAG, anda 
Carriage RETURN/LINE FEED sequence. 


LeSO0uuPRINT lly 7979" >" when output to a teleprinter 
causes two Carriage RETURN/LINE 
FEED sequences, followed by two 
rings of the bell, anda '>' 
character. 


When using the TYPE and PRINT commands to a terminal or the line 


printer, each line output should be terminated by a '!' form control 


character to prevent overprinting on the device. When output is to 


a storage device (paper tape, magtape when the DOS format is selected, 


DECtape, or sequential disk processor) omission of a terminating '! 


causes the concatenation of the line with the one which follows it. 


On the paper tape punch, concatenated lines should not exceed 132 char- 


acters; otherwise, an 'LBOV' error occurs on input. The sequential disk 


processor (SDP), DECtape, and magtape force an EOM condition if more 


than 132 characters are input. Except when the "V" magtape format is 


selected, the next input request starts where the last terminated; thus 


no data is lost. Therefore, to conserve space on a tape, it may be de- 


Sirable to concatenate lines. 
Examples: 


>S 


LI="NOW IS THE TIME FOR" 


>S_ L2="ALL GOOD MEN” 


1.22 A 55:2000 T L1,!,L2,! U 55 
1.308 A 5532008 R X1,x2 U 55 
(40 -T "XLS" XI, thee", xO 21 
>D_1 

X!=NOW IS THE TIME FOR 

X2=ALL GOCD MEN 


1.22 A 5522000 T 11,L2,! U 55 

1.38 & 55:200% R X1,x2 U 55 

Leal PS OX To Ke a Ke 4 
.>fp J 


Y1=NQW If THE TIME FOR ALL GOOD MEN 
xeznext line from the input device 


the eontents of both Li 
and L2 are terminated by 
the '!' durtng output to 
DECtape (device 55) and 
are thus read back on tin- 
put as two separate lines. 


stnee there ts no termina- 

tor between L1 and L2, they 
are treated as one concate- 
nated line and on tnput X1 

contains the ortgitnal econ- 

tents of LZ and L2 while X2. 
contains whatever ltne fol- 
Lowed these on the tape. 


The horizontal tabulation character '?' is particularly useful when 
formatting columns of data for output to terminal devices (device 
numbers 1, 4-19, 64-111.+ Because tabulation is relative to the 
absolute left margin, each successive tabulation on a line must show 
an increasing number of spaces in order to effect a change in column 


position. 
Example: 
>TYPE 710 ,"A",718,"B" 
results tn 


(10 spaces) AB 


not 


(10 spaces)A(10 spaces)B 


However, 


SIYPE 710. e721. RR" produces the second result 


In any line of text, if one string overlaps the Starting position 


for a '?nve! formatted string, the '?nve' string starts on the next 
available character position. 


Examples: 
>SET A=17 


o TYRE Ay Pos "METERS" 
17 METERS 


Or 
“SET A="SEVENTEE Nu" 


“TYPE Ay ?Ss "METERS" 

SEVENTEEN METERS 
3.5.2 Margin Control 
The programmer may set arightmargin for terminal devices (devices l, 
4-19, 64-111) and the line printer (device 3) when he ASSIGNs the device. 
When the device is UNASSIGNed, the system cancels margin control. The 
MUMPS-11 Language Reference Manual discusses the use of the ASSIGN command. 


Examples: 
RIE oy re sets the right margin of the Prtnetpal 
I/O Device to character posttton 72 
A 3:80 sets the right margin of the line printer 


to character posttton 80 


‘The horizontal tabulation character can also be used to send a speci- 
fic number of blanks through the in-core job communication devices, 
for example: 


A 112 T ?5 send through 5 blanks. 
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3.5.3 $X and $Y System Variables 


The $X and SY System Variables provide the following information to 


assist the user in formatting output lines on terminal-type devices: 


SX - contains the running total of the number of char- 
acters output since a Carriage RETURN or FORM FEED 
on the current I/O device. 7 


SY - contains the running total of the number of line 
feeds sent since the last Page or FORM FEED on the 
current output device. SY is automatically reset 
to Q when the 66th line is reached. — 


3.6 I/O ERROR PROCESSING 


MUMPS considers DECtape, line printer, and disk I/O errors fatal. 
MUMPS reports an appropriate Operating System Error Message (Appendix 
C) on the Principal I/O Device and halts the program.! The program- 
mer may choose to handle his own error processing and write a routine 
using the SE system variable (see 5.3). 


MUMPS does not consider I/O errors associated with terminals, 

paper tape reader/punch, sequential disk processor, or CPU-CPU 

devices fatal. MUMPS reports the hardware status for the currently 
assigned device in the $A System Variable after each request’. The 
user must check $A after each I/O operation’ to determine if it was 
successful, and if not, to determine what kind of error occurred. 

MUMPS does not consider line printer or magtape I/O errors fatal* un- 
less the user SETs the SE System Variable. If SE is not used, the 
system only reports an error in the SA System Variable. If SE is used, 
the system generates an 'MTERR' or 'LPERR' and passes control to the 


user's error processing routine. 


‘Tf an error occurs during output to DECtape, MUMPS attempts to write 
out the contents of the current buffer before the program halts. 


2Tf an error occurs during an I/O transfer to a terminal device, the 
current line of data being transferred is lost. If a BREAK or CTRL/C 
is received, the data being transferred is lost unless the programmer 
controls interrupts when using the $J System Variable. 


If the programmer wishes to check the hardware status of a device 
before the first I/O request (for example, to check a line printer- 
not-ready condition), he must use the $VIEW function to interrogate 
the hardware status register in memory. 


"If an error occurs during output to magtape, MUMPS attempts to write 
out the contents of the current buffer before reporting the error. 

If an error occurs during either input or output, the system positions 
the tape after the block causing the error, unless an error occurs on 
the backspace or erase portion of a retry. 


3-3 


3.7 I/O DEVICE CHARACTERISTICS 


The following paragraphs describe the programming characteristics of 
MUMPS I/O devices. Users interested in specific hardware characteris- 


tics should refer to the PDP-11l Pertpherals and Interfactng Handbook. 


3.7.1 Terminals 


3.7.1.1 General Description - Terminals in MUMPS-11l1 systems include, 
but are not limited to, ASR33 Teletypes, VT05/VT50/VT52'/vVT55 Video 
Terminals, and LA30/LA36 DECwriters. The system may have up to 17 
remote or local single-line terminals, and up to 48 local or remote 
terminals on 3 DH11 multiplexer lines or 6 DZ1l1 multiplexer lines, 

or a combination of both (see Section 3.7.1.2 following). Any one of 


the single-line devices 4-19 may be a CPU-CPU device. 


3.7.1.2 Device Numbers - 


Number Device 
1 Console Terminal 
4 Terminal #1 (single-line) 
+ + 
19 Terminal #16 
64 Terminal #1, DH Multiplexer #1 2 DZ multiplexers’ 
; P (device #1 and 
#2) with 8 ter- 
79 Terminal #16, DH Multiplexer #1 minals on each. 
80 Terminal #1, DH Multiplexer #2 t DZ multiplexers 
1 | (device #3 and 
ved #4) with 8 ter- 
95 Terminal #16, DH Multiplexer #2 minals on each. 
96 Terminal #1, DH Multiplexer #3 2 DZ multiplexers 
1 1 (device #5 and 
#6) with 8 ter- 
bE sh Terminal #16, DH Multiplexer i. minals on each. 


1A special set of ESCape sequences can be used with the VT52. Refer 
to Section 3.7.1.4 for further information. 

*The device assignments for the DZ multiplexers assume that DZ and DH 
multiplexers are not used in combination. When used in CORDES EON 
DH multiplexers get the lowest device number assignments. 


3.7.1.3 Applicable Commands - 
Output 


WRITE 
TYPE 
PRINT 


Input 


READ 
LOAD 


3.7.1.4 Special Characters and Functions - The special keyboard func- 
tions shown in the following list cannot be input as data from MUMPS-11 
terminals, since these functions are used to provide the user with 
program and data I/O control. (Paragraph 2.4 describes in detail the 


operation of the control character functions.) 


Function Description 


CTRL/C Reguest to log-in or attempt to 
terminate a running program. (See 
the ASSIGN command in the MUMPS-11 


BREAK Language Reference Manual fora 
discussion on enabling BREAK and 
CTRL/C.) 

CTRL/U Delete input. line if it has not been 
terminated by a Carriage RETURN. 

RUBOUT Delete last character typed if previous 
character was not a Carriage RETURN. 

ALT MODE 

OR Terminates input lines from the 


terminal. 
Carriage RETURN 


CTRL/O Suppresses or restores output printing 
on terminal. 


Line Feed Ignored by MUMPS (not echoed). 


CTRL/S Stops printing at terminal until a 
CNTL/Q is hit. (CTRL/S is equivalent 
to X OFF on some terminals.) 


CTRL/Q Resumes printing at last character of 
output. (CNTL/Q is equivalent to X ON 
on some terminals.) 

In addition to the control (CTRL) character functions, there are a 
special set of functions, used solely with the VT52, which use key- 
board characters in combination with the ESC key. These combinations 


are called ESCape sequences. 
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The ESCape sequence iS input to the computer in a different manner 
than the CTRL characters (see Section 2.4). The ESC key is pressed, 
but is then released before the associated character key is pressed. 


Whenever an ESCape sequence is input, the $H system variable is set 
to a unique code (see Table 2-2). On input of a Carriage RETURN or 


an ALT MODE, SH is set to zero. 


The following character codes have special meaning to the terminals 


and can be used with the PRINT command. 


Decimal 
Code Description 
Teletypes: 07 BELL 
g9 Horizontal TAB 
(not all eodes 1g LINE FEED 
have meantng ik Vertical TAB 
to all ver- 12 FORM Feed 
stons of 13 Carriage RETURN 
Teletypes) 
O7 BELL (produces an audible sound) 
08 , Backspace (cursor left one space) 
G9 | Horizontal TAB 
1g LINE FEED 
11 Cursor Down (one line) 
13 Cursor RETURN 
14 Enter cursor addressing mode and 
accept the ASCII value of the next 
VT@5 Displays: two characters as the Y and X coor- 
dinates of the new position of the 
cursor. ? 
24 Cursor Right (one space) 
26 Cursor Up (one line) 
29 Home (cursor to top line, first 
character position) 
39 Erase to end-of-line 
31 Erase to end-of-page 
VT5% Displays: The VT50 display has a number of 


device-dependent capabilities that 
are accessed via an ESCape sequence 
protocol. This information is 
contained in the 7&0 Programmers' 
Reference Manual, DEC-00-OUTSA-A-D 
and in DECscope User's Manual, 
EK-VT5X-OP-001. 


‘Refer to the V705 Reference Manual, DEC-OO-H4AC=-D for further information. 


hat Be 


Decimal 
Code Description 


VT52 Displays: The VT52 display has a number of 
device-dependent capabilities that 
are accessed via an ESCape sequence 
protocol. This information is con- 
tained in the DECscope User's Manual, 
EK-VT5X-OP-001., 


NOTE 
See Section 3.7.1.4 for an additional 


set of ESCape sequences which work 
in conjunction with $H system variable. 


(Used exelu- 27,61 Causes alternate mode to be entered 
stvely with which will generate the following 
the PRINT sequences. Keys 0-9 will set SH to 
command) 0 to 9. 

27,62 Switches back out of alternate mode. 
VT55 Displays: The VT55 display has a number of 


device-dependent capabilities that 
are accessed via an ESCape sequence 
protocol. This information is con- 
tained in the V255 DECgraphic Scope 
User's Manual, EK-VT55A-TM-002. 


3.7.1.5 Error Conditions - If the currently ASSIGNed terminal is a data 
set, MUMPS reports its hardware status in the SA System Variable. Table 


3-2 lists the bit assignments for the data set hardware status register. 


Table 3-2 


SA Bit Assignments for Data Set Devices! 


| First Word* Second Word* 
Meaning when Set to l Meaning when Set to l 


Reader Enable” 

Terminal Ready 

“Request to Send 

Secondary Transmitted Data* 
Unused | 

Data Set Interrupt Enable 
Receiver Interrupt Enable 
Receiver Done or Ready 
Unused 

Busy 

Receive Data Parity Error 
Framing Error? 

Data Overrun 

Data Error 


Disconnected 

Secondary Received Data? 
Receiver Active 

Carrier Detection 

Clear to Send 

Ring Indicator 

Data Set Status Change 
Unused 


SH OB WN EO 


*The number obtained from SA is a 2-word number (l.e., a double numeric 
datum). Bits can be tested using procedures described in oe ie 


‘CPU-CPU device SA bit assignments are discussed in paragraph 3.7.6. 
~?Not relevant. 


‘Treated as a BREAK character by MUMPS. 
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Local single-line terminals use only bits 7, 11, 15 of the first 


words Multiplexer terminals also use bits 12-14 of the first word. 


Remote single-line data set terminals use all assigned bits for status 
reporting. If the data set is disconnected, MUMPS sets bits 0-7 

in the second word of SA. If the data set terminal is the currently 
ASSIGNed device and is disconnected without being UNASSIGNed, the 
program is hung. If there is no activity on the disconnected data 
set line for 15 seconds, MUMPS halts the program, unassigns the ter-. 


minal and disconnects the data set from the telephone line. 
3.7.2 Paper Tape Reader/Punch 


3.7.2.1 General Description - The PCll High Speed Reader/Punch station 
reads and punches folded-form 8-channel, oil-less, grey, l-inch paper 
tape. Data resides on paper tape as 7-bit ASCII characters, one 
character per frame. Unless parity checking (even) is requested during 
system generation, parity is not computed and bit 8 (parity bit) is 
always punched. The reader/punch is programmed in the same way as 


are terminals. 


3.7.2.2 Device Number - The reader/punch is device number 2. 


3.7.2.3 Applicable Commands - 


Output 


TYPE 
WRITE 
PRINT 


Input 


READ 
LOAD 


3.7.2.4 Special Characters - CTRL/C (003) may be read from paper 


tape to effect job stream control and log-in. 


3.7.2.5 Error Conditions - Errors are ignored on output. An error 


on input will force an EOM, thus ending the LnpUts 


In general, the errors generated by the reader/punch are 'not-ready' | 
conditions: the punch is out of tape or the power is off; the reader 
is out of tape, off-line, or the power is off. MUMPS reports an 
error condition by setting bit 15 in the $A System Variable. After 
the programmer issues an I/O request, he may check the status as 


illustrated in the following example: 
6.45 IF $A/1008&327.68 (go process error) 


The user can check for an initial 'not-ready' condition on the punch 
before issuing any I/O requests by $VIEWing the device's hardware 
status register. The address of the status register for the punch is 
65388) 4 for the reader, 65384, For both, bit 15 is set (to 1) if 
an error condition exists. The following command line checks the 


punch for a 'not-ready' condition. 


4.34 IF $V (65328) /19683827.62 (go process error) 


If parity checking (only even) was requested at system generation, the 
user may check for parity errors by testing out bit 12 in the SA 
System Variable after the I/O request. 


2.180 IF $A/1008&42.96 (go process error) 


3.7.3 Line Printer 


3.7.3.1 General Description - The MUMPS System operates with any 


one of the following four line printer models: 


Graphic 
Type Characters/Line Character Set 
LP11F 80 64 
LP11H | 80 96 
LP11lJ 132 64 
LP11K 132 96 
LP11R 132 64 
LP11S : 132 96 


3.7.3.2 Device Number - The device number for the line printer 


is 3. 


3.7.3.3 Applicable Commands - 


Output 


3.7.3.4 Special Characters and Functions - The Following codes can 
be output with the PRINT command to effect format control as follows: 


Code Description 
19 Line Feed 
12 FORM Feed (Top of Form) 
13 Carriage RETURN 


3.7.3.5 Error Conditions - When one or more of the following error 
conditions occur, the SE System Variable is set to a value of -0.38: 

OFF LINE 

OUT OF PAPER 

YOKE OPEN 

POWER OFF 
If the SE System Variable is not being used, the programmer should 
first check the line printer status by using the $VIEW function to 
check the error bit (bit 15) of the device's Status Register. The 
address of the Status Register is 65356, )- The following command 


line checks this error bit. 


8.66 IF $V (65356) /1908327.68 (go process error) 
3.7.4 DECtape 
3.7.4.1 General Description - Up to two TU56 Dual DECtape transports 
can be used on MUMPS systems, providing up to four logical units. 
DECtape is used as a linear storage device, similar to paper tape. 
The tape is organized into 578 contiguous blocks of 512 characters 


each, providing up to 295,936 characters of storage. 


On output, MUMPS lines are packed into a 512-byte buffer. The buffer 
is output to the tape drive when it is determined that the next 
character of a line to be packed would exceed the size of the buffer. 
The null byte at the end of each line is discarded. On input, Carriage 


RETURNS are converted to nulls. 


3.7.4.2 Device Numbers - 


Number Device 
55 DECtape Unit 9g 
+ + 
58 DECtape Unit 3 


3.7.4.3 Applicable Commands - 


Output 


TYPE 
WRITE 
PRINT 


Input 


READ 
LOAD 


3.7.4.4 Special Characters and Functions - 
a. Positioning the DECtape: 


DECtape is positioned through use of the special 
':nve' syntax of the ASSIGN command. This argument 
specifies the address in bytes of the next character 
position to be read or written. The address must be 
a positive integer between @ and 295,935. This address 
is placed in the SA System Variable. Thus, it is 
really SA that specifies the DECtape address. If 

no address is specified in an ASSIGN command, SA 

is not changed, and the drive is enabled for sub- 
sequent I/O transfers. $A is updated by the DECtape 
driver to the current address after each I/0 
request. The user can interrogate SA as needed. 


b. Buffers 


DECtape is a buffered device. A 256-word buffer is allocated 
On an ASSIGN and deallocated on an UNASSIGN. Further, part 

of the deallocation process is the writing of a partially 
filled buffer if the last I/O request was a WRITE, TYPE, or 
PRINT. Since a buffer is written out on the tape only when it 
is full, an UNASSIGN should be used to terminate the OUTPUT 
sequence to prevent the loss of data remaining in the last 
buffer. This same sequence is automatically performed on a 
HALT or a terminal error. If, however, the error originates 
from the DECtape unit, the last buffer may not be written out. 


3.7.4.5 Errors - The 'DTERR' error message results from these error 


conditions: 
DECTAPE OFF T.INE 


NOT WRITE ENABLED 
UNIT NUMBER NOT SELECTED 


HARDWARE ERROR ON TAPE 
3.7.5 Magnetic Tape 


3.7.5.1 General Description - Magnetic tape devices which are compat- 
ible with the MUMPS system are the TJU16 and the 7- or 9-track models 

of the TU1Z. Up to four logical transports can be used, but TU1%/s and 
TIU16S cannot both be utilized on the same system. The recording mode 
is either industry standard 9-channel mode or 7-channel dump mode. The 
800 bpi and lower densities use NRZI recording whereas 1600 bpi is phase 


encoded. 


O16 


Labeling conventions, character sets (ASCII or EBCDIC), data formats, 
and physical block size are program selectable. Default values for 
these parameters may be modified by the MSP (modify system parameters) 
program. One possible default value is a DOS-11l compatible format. 
Thus the former MUMPS magtape handler which only permitted a DOS-11 


compatible format is upwards compatible with the new MUMPS magtape 
handler. 


Once a magnetic tape unit has been used for either input or output it 
must continue to be used for that same function until either the unit 
is UNASSIGNed or a backspace, forward space, or rewind (PRINT 1, 2, 

or 5) has been issued. Failure to use the unit in this manner results 


in an error. 


3.7.5.2 Device Numbers - 


Number Device 
47 Magtape Unit @ 
{ { 
50 Magtape Unit 3 
3.7.5.3 Applicable Commands - 
Assignment 
ASSIGN 
UNASSIGN 
Input 
LOAD 
READ 
Output 
PRINT 
TYPE 
WRITE 


a. ASSIGN Command 


‘The format of the ASSIGN command for magtape is as fol- 
lows: 


Assign.unve,{:svet:nve,{:nve,}}} 


When the ASSIGN command is used to establish device 
ownership, the tape format parameters for subsequent 
I/O are established. The tape format which is used 
for the ASSIGN is the default format (specified by 
the MSP program) modified by the optional arguments 
of the ASSIGN command. The optional arguments in 
future ASSIGNs of the unit are ignored until the unit 
has been UNASSIGNed. The specification of a tape 
format which is different from the default format 
remains in effect only until the unit is UNASSIGNED. 
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~Each character of the optional string (sve) represents a for- 
mat switch. The effect of each of these switches is described 


in Table 3-3. Not all switch combinations are permissible; 
Table 3-4 indicates which switches are allowable. 


The variable nve, specifies a fixed-length logical record 
size in bytes. tts value must be @ if a fixed-length record 
format is not being used, and its value must be within the 
range of 1 through 132. The variable nvey specifies a physi- 
cal block size in bytes. Its values may range from 149@ 
through 512 but must be an even value. An odd value will 
give a magtape error. : 


Examples: 
3.51 A 47 reserves magtape unit 9 with 
the default format 
4.5 BW 47:"AVL" reserves magtape unit @ and 


specifies the ANSI standard 
"D" format (labeled) 


4.9 A 47:"EUF":88:249 
reserves unit @ and specifies 
unlabeled EBCDIC with 89- 
character fixed-length rec- 
ords and 249 byte blocks (3 
records per block) 


An ASSIGN which establishes ownership of a magtape unit 
will poll that unit to determine its status, and that 
status is used for the SA reserved word. Subsequent 
ASSIGNs do not poll the drive, and SA then refers to the 
last I/O operation of the unit. 


. .UNASSIGN Command 


An implicit "PRINT 9" (write an EOF label) is performed 
if the program has been performing output. That is, the 
current contents of the buffer (if any) is output and 
then, if the unit is not on a tape mark, an EOF label 

is written. Note that an UNASSIGN immediately following 
a "PRINT 8" (write a file header label), for a non-DOS 
labeled format, does not perform additional output since 
the buffer is empty and the unit iS on a tape mark. 


PRINT Command 


The control codes shown in Table 3-5 may be used as © 
arguments to the PRINT command to effect special tape 
functions. 


LOAD and READ Commands 

An implicit "PRINT 7" (read a label) is performed on 
input if the tape is at the beginning-of-tape (BOT). 
TYPE and WRITE 

An implicit "PRINT 8" (write a header label) is per- 


formed on output if the tape is at the beginning-of- 
tape (BOT). 


S=1E 


Se/ i004 


Operations and Tape Formats - 


Normal Usage: 


To output a single file to magtape, a program should 
Simply ASSIGN the unit, issue a "PRINT 5" to rewind 

the tape if it is not already at the beginning of the 
tape, output the data, and then either UNASSIGN the 
unit or use "PRINT 5" to rewind the tape. A partially 
filled output buffer is written, and the appropriate 
labeling is automatically performed. The volume and 
header labels are automatically skipped on input, if 
the tape is at the beginning of tape location, and a 
tape mark condition indicates the end of a file's data. 


Labels: 
There are four labeling options: 
1. DOS-11l compatible label 


A 7-word label appears at the beginning 
of the tape and a tape mark appears at 
the end of the file. 


2. ANSI standard label 


Figure 3-1 illustrates a single and a 
multiple file tape using ANSI standard 
labels. 


3. IBM standard EBCDIC lahel 


With the exception of minor internal 
field differences and the EBCDIC char- 
acter set, this labeling convention is 
the same as the ANSI standard. 


4. Unlabeled 


ANSI standard labels are generated if the ASSIGN switches 
"Tr" and "A" are present (or are default switches). IBM 
Standard labels are generated if the "L" and "E" switches 
are present (or are default switches). The volume identi- 
fier is "MUMPS1", and the file identifier for every file 
on the tape is "MUMPS.SRC". The file sequence number of 
the first file is 1. The sequence number is incremented 
by one for each subsequent file on the tape. 


DOS-11 compatible labels use the file name "MUMPS.9@@1". 
Multiple Files: 


To write multiple labeled ANSI standard or IBM 
standard files, the following sequence should be 
used. 


-.. write file, PRINT 9,1,8 write file, er 


ae 


Note that if nothing is output for file , a subse- 
quent UNASSIGN or rewind will not properly close 

that file. A "PRINT 9", however, will still properly 
close that null file. . 
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To read multiple labeled ANSI standard or IBM 
standard files, the following sequence should be 
used. 


... read file, read the tape mark PRINT 7,7 read file. +. 


ay ed 


d. Data Formats: 
Any of three data formats can be selected. 
1. Stream 


Characters are sequentially packed into 
blocks. On output, a carriage return/ 
line feed sequence is translated to a 
line feed, and if a line cannot fit into 
a block, the block is padded with NUL 
characters and the line is the first line 
of the following block. On input, line 
feeds, form feeds and vertical tabs are 
converted to EOMs!, and carriage returns 
are discarded. On input, a NUL character 
is interpreted as the end of a block and 
input for that READ continues with the 
first character of the following block. 


2. Variable Length Record 


Figure 3-2 illustrates the variable length 
format. Each string is preceded by a 4- 
byte numeric character offset whose value 

is the byte-length of the data string plus 

4 for the offset length. If the next string 
plus offset cannot fit into the block, a 
caret (*) appears in the first character 
position of what would have been the next 
offset, and the string and its offset ap- 
pear in the following block. This format 

is the ANSI standard "D" format, and it is 
selected by the ASSIGN switches "A" and "Vv". 


The ASSIGN switches "E" and "V" select the 
EBCDIC version of the ANSI standard "D" format. 
The EBCDIC version is the same except that 
every data block begins with a 4-byte numeric 
character block offset. This block offset 
equals the length of all of the strings and 
their offsets that are in the block plus 4 

for the block offset length. 


On output, each argument of the TYPE command 
is treated as a separate string, and the EOM 
character is not output. There is no char- 
acter translation, other than EBCDIC transla- 
tion if that switch option was selected. 


‘End-of-message for which, internally, MUMPS uses a NUL character. 
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3. Fixed Length 


The fixed-length data format requires the specifica- 
tion of record length (from 1 to 132 characters) in 
the ASSIGN command. Input occurs until the speci- 
fied number of characters is read or until a NUL 
character is encountered. After a NUL character is 
encountered, the remaining characters in that record 
are skipped, and input resumes at the beginning of 
the next record. Output uses the same format as the 
Stream format; there is no padding of record length. 
Thus, programs may output individual fields of a 
logical record at different points in a program. 

The specification of block size should be an integer 
multiple of the record size. 


e. Status Register: 


MUMPS uses the SA System Variable to communicate to the 
user the results of each magnetic tape operation. Table 
3-6 defines the meaning of each bit when set to l. SA 
represents the status of the unit at the completion of 
the last physical I/O operation, except when an ASSIGN 
command which establishes ownership of the unit is issued 
(see Section 3.7.5.3a). SA bit assignments for the TUI16 
are different from those for the TU1@ or TS@3. 


f. Buffers: 


A buffer is allocated for the magtape unit on an ASSIGN 
and deallocated on an UNASSIGN. Part of the deallocation 
process is the writing of a partially filled buffer if the 
last I/O request was a WRITE, TYPE, or PRINT. Since only 
full buffers are written on the tape, it is essential that 
the last request in an output sequence be an UNASSIGN or 


one of the special functions, "PRINT 9" (write an EOF) 
or "PRINT 5" (rewind) or, in the case of a DOS-11 label 
format, "PRINT 3" (write a tape mark). Otherwise, the 


contents of the last buffer will be lost. This same 
sequence is automatically performed on a HALT. 


gG.- Compatibility with the Former MUMPS Magtape Handler: 


Version 3 of the MUMPS magtape handler permitted 

only a DOS-11 compatible format. The old handler is up- 

ward compatible with the current handler through selec- 
" tion of the DOS-11 compatible format as the default 

format. 


3.7.5.5 Error Conditions - No magtape errors are terminal unless 

the user has set the SE System Variable; they are reported back to 
the user in the SA System Variable. When SE is used, control trans- 
fers to the specified step or part for user-supplied error processing. 
If SE is not used, the user should interrogate SA after each I/O 


request to ensure that the request was successful. 


@ A logical error iS a programming error which can re- 
sult from an attempt to mix input and output. Once a 
tape has been selected for reading or writing, it must 
be used for the same function until either the unit is 
unassigned or a PRINT command argument. of 1, 2, or 5 is 
issued. 


A logical error can also be caused by an error in the 
record or block size offset characters which are used 
in a data block which was recorded with the variable 
length data format. 


& A tape-not-ready condition is caused by the following: 
the unit is not selected, the power is off, or an at- 
tempt is made to WRITE on a WRITE-protected tape. It 
is possible to check the latter before issuing the I/O 
request, as detailed in the examples: below. 


® The following errors usually indicate 
a hardware problem if they occur repeatedly: 
nonexistent memory, bus grant late, and cyclical 
redundancy. 


® Bad tape and parity errors most likely indicate a 
physically bad tape. 


@ An EOF terminates an input operation. 


For all errors except logical error and tape-not-ready conditions, the 


magtape is left positioned after the block that caused the error. 


On input, the detection of an error forces an EOM and return to the 
user. In most cases, this results in a null string being returned; at 


best, only a partial string is returned. 


If an error occurs during an output operation, the output buffer re- 
tains its data and may be output, after consideration of tape position 
and correction of the error condition, by "PRINT 4". The first suc- 
cessful output operation or a TYPE or WRITE, whichever occurs first, 
will zero the buffer. 


To determine the presence of an error or EOT, SA must be interrogated 
after each I/O request. Each bit can be individually examined by 


using the masking procedure described in paragraph 5.1. 


Examples for use with the TU10 drive: 


® To check the tape on unit @ for a not-ready 
condition: 
3.33 A 47 IF $A/12808&327.68 (go process error) 
e To check unit @ for any error: 


22.92 A 47 IF $A/1608485.22 (go process error) 


® To check for an EOT on unit @: 


(go process end- 
3.56 A 47 IF $A/18041H.24 of-tape condition) 


To ensure that a tape is write-enabled, check the magtape hardware 
status register before issuing the output request. The address is 


62800, , for the TU1O and 62762, 5 for the TJU16. Bit 2 for the TU10 


or bit 11 for the TJU16 is set if the tape is Write-protected. 
Example for the TUl10: | 


6.99 IF $V( 62820) /100&.84 (go process error) 


Table 3-3 


Magtape ASSIGN Switches 


Switch 
Character Meaning Effect 


ASCII 


Selects ASCII character set. 
DOS-11 Compatible Uses DOS-11 labeling, the ASCII 
character set, and the stream 
data format. 

EBCDIC Translates ASCII characters to 
EBCDIC on output, and EBCDIC 
characters to ASCII on input. 


Fixed Length Records 
Data Format 


Assumes fixed length logical rec- 
ords for input, and uses the 
stream data format for output. 
Thus, there is no automatic pad- 
ding of record length on output. 
This switch reguires the presence 
of an additional argument on the 
ASSIGN command which specifies 
record length. 


Standard Labeling Uses ANSI standard labels with 
the ASCII character set. Uses 
IBM standard EBCDIC labels with 
the EBCDIC character set. 
Stream Data Format On output, packs characters se- 
quentially into the buffer, and 
CR-LF translates to LF. Strings 
are not split across block bound- 
aries; instead, the buffer is 
padded with null bytes. On in- 
put, treats LFs, VTs, and FFs as 
string delimiters, and ignores 
CR. Thus, on output, data is 
effectively concatenated until 
terminated by a CR-LF. 

Unlabeled Does not provide labels. Pro- 
grams that need a tape mark out- 
put at the end of a file must 
issue a "PRINT 3" after writing 
the file. 


Variable Length 
Records Data Format 


This data format corresponds to 
the ANSI standard "D" format or 
the EBCDIC "Vv" format, depending 
upon whether the ASCII or the 
EBCDIC character set has been se- 
lected. Each argument of a TYPE 
command corresponds to a logical 
record which can be read as a 
Single argument of a READ com- 
mand. — 


Table 3-3 (Cont.) 


Magtape ASSIGN Switches 


Switch 
Character Meaning 


az 


Table 3-4 


The low order bits of the digit 
are used as the density bit pat- 
tern specification for the mag- 
tape unit. Note that there is 
no special translation to 6-bit 
characters for 200 or 556 bpi. 


For the TJU16, a "3" specifies 
800 bpi, and a "4" specifies 1600 
bpi. 


Legal ASSIGN Switch Combinations 


Switch combinations denoted by an "X" are permissible. 


OWITCH 


Table 3-5 


Magtape Control Codes 


Backspace Backspaces one record.!? 


Forward Space Spaces forward one record or tape mark. 
If the format is DOS-1ll compatible and 
the tape is at BOT, the label is skipped 
before the forward space is performed. 


Write Tape Mark Writes a tape mark on the tape.’ 


Write Block Writes out the current buffer. If the 
format is DOS-11 compatible and the tape 
is at BOT, a volume label is output be- 
fore the buffer. 


Rewind If the last function was an output opera- 
tion, an implicit "PRINT 9" is performed. 
The tape is then rewound.? 


Read Block Either the next block is read into the 
buffer or a tape mark is read. If the 
format is DOS-11 compatible and the tape 
is at BOT, the volume label is skipped 
before reading the block. 


Read Label If the DOS-11 format is selected. one 
block is read. If any other labeled 
format is selected, blocks are read un- 
til a tape mark is encountered. The 
buffer pointers are set to indicate that 
the buffer is empty. This code may be 
used for volume labels, file header 
labels, and EOF labels. 


Write Header Label| If the DOS-11 format is selected, a 
DOS-11 label is output. If any other 
labeled format is selected, the sequence 
"HDR1,HDR2,tape mark" is output and that 
sequence is preceded by a volume label 
if the tape is at the beginning of tape 
(BOT). This code is ignored for unlabeled 
formats. | 


Write EOF Label If the DOS-11 or an unlabeled format is 
selected, outputs a tape mark. Other- 
wise, outputs the sequence "tape mark, 
EOF1,EOF2,tape mark,tape mark".? 


‘The execution of this code clears the read only/write only switch. 
Subsequent magtape I/O establishes the new mode for that switch. 


If the last function was an output operation and data remains in the 
buffer, the contents of the buffer are written out before any other 
decisions are made or actions are taken. 


Single File’? 
VOL,HDR1,HDR2*...data...*EOF1,EOF2** 
Multiple Files? 
VOL,HDR1,HDR2*...data...*EOF1,EOF2*HDR1,HDR2*...data... 
*EOF1],EOF2*HDR1...EOF2** 


‘Rach asterisk represents a tape mark. VOL, HDR1, HDR2, EOF1, and 
EOF2 are each ANSI-specified 8f-character blocks. 


Figure 3-1 ANSI Standard Labels 


A data block for the ANSI Standard "D" Format (selected by the ASSIGN 
switch combination "AV...") 


x 


1 2 


one physical block 


A data block for the IBM standard "V" Format (selected by the ASSIGN 
switch combination "FV...") 


et gee: — _ 


1 2 


BL 


one physical block 


Figure 3-2 Variable Length Record Format 


Table 3-6 


Magtape Device SA Bit Assignments 


TU1# Assignment TU16 Assignment 


*Logical Error! *Logical error 
Beginning of tape 
Tape mark 


Tape write protected 


7-channel operation (9 
indicates 9-channel) 
Beginning of tape 
*Nonexistent memory 
*Bad tape error?’ 
Record length error 
End of tape? 
*Bus Grant late’ 
*Parity error 
*Cyclical redundancy? 
Tape Mark 
*Tape not ready 


Phase encoded 


Drive ready 


End of tape’? 
Tape write protected 


*Any error condition 


*error condition 


‘A logical error is the software condition resulting from either an at- 
tempt to mix input and output or a record or block size error. 


The system retries 13 times before giving this error. If it is a 
WRITE operation, the retry attempts are made with an extended record 
gap. 


7This bit is set on detection of an EOT. It stays set until a REWIND 
or BACKSPACE occurs. The uSer may continue. 


3.7.6.1 ‘General Description - The CPU-CPU device allows a MUMPS-11 pro- 
gram to communicate with a program running on another central processor 
(CPU). This device is an asychronous, half-duplex, serial communications 
line that connects the MUMPS-11 CPU to another CPU. 


The CPU-CPU device has two operating modes or states: terminal state 
and message state. In terminal state the device operates exactly as 
if the remote CPU were a MUMPS-11 terminal with a 72-character 
maximum line length. In message state the device transmits and 
receives data as formatted messages. The state of the device is set 


by using the conditional syntax of the ASSIGN command: 
Awsn:bve 


wheres n = CPU-CPU device number 
sbve = True (-.@1) = Enter message state 


False (@) = Enter terminal state. 


The default state for the device is terminal state. An UNASSIGN command 


directed to the device causes it to enter terminal state. 


3.7.6.2 Device Numbers - A CPU-CPU device may use any one of the device 
numbers (4 through 19) allocated for terminal use as established by 
the system manager during system generation (described in the MUMPS-11l 


Operator's Guide). 


3.7.6.3 Applicable Commands - 


Output Input 
WRITE READ 

TYPE LOAD 

PRINT 


3.7.6.4 Message State Operation - In general, the CPU-CPU driver 
handles all communication operations, other than error detection and 
correction. The device does not attempt to interpret any special 
system characters, for example, CTRL/O or CTRL/C. 


a. Data Transmission Protocol 


1. The remote application program must send a complete message 
in the form shown in (h.) helow, using a single output command. 
If the remote program transmits a message in several parts, 
the operating system may swap the program out between parts. 
The receiving program's message reception time interval may 
expire causing it to report that the remainder of the message 
was lost in transmission. 


2. The two communicating programs must agree on the conditions 
that determine when each program becomes the sender or 
receiver. If hoth programs attempt to send messages. 
Simultaneously, an interlock occurs and neither program can 
complete a message transmission. 


3. The receiving program must acknowledge the receipt of each 
message. A positive acknowledgment message (ACK - see 
below) is sent when a message from the other computer is 
received correctly. A neaative acknowledgment message (NAK - 
see below) is sent if a message is not received correctly. 
When the sending program receives positive acknowledgment 
it may transmit another message. If the program receives 
a negative acknowledgment, it must retransmit the last message. 
In order to determine if a message was transmitted correctly, 
the remote receiving program must verify the message format and 
perform cyclic redundancy check (CRC) calculation. These tasks 
are performed automatically by the MUMPS-11 CPU-CPU device. 


b. Message Formats 


1. The CPU-CPU device buffer for I/O data is 80 characters 
(ASCII) long. The application program may, therefore, trans- 
mit messages in blocks no larger than 89 characters. The 
standard CPU-CPU device message format includes header and 
trailer information, as indicated below. 


SOH Start of Header (001) 
Message Number 9-17 Octal 
Character Count Number of characters of data 
STX Start of Text (002) 
Data 
. planes of characters as specified 
: in the character count 
ETX End of Text (003) i 
BCCl] ener cyclic redundancy check (CRC) 
BCC2 qenerated from all previous characters 
in the message. 


2. An acknowledgment message is in the format shown below: 


SOH Start of Header (001) 
ACK, Message Number Acknowledge Message -40, OR'ed with 
~-Oor- message number 
NAK, Message Number Negative acknowledge -120, OR'ed with 
message number 
BCC1 16-bit CRC for the two previous 
BCC2 } characters 


ce. Calculating the Cyclic Redundancy Check (CRC) 


The CRC is a method for verifying the accuracy of message data. 
For further information, see the subroutine which calculates the 
CRC in Appendix H. 


d. Message Terminator 


MUMPS normally interprets the character "!" as a format control 
character that initiates a Carriage RETURN/LINE FEED sequence 

on an output device. If the device is in terminal state and it 
encounters an "!" in an output message, it interprets the 
character as the standard message terminator and sends the 
message and an EOM (null string) to the recipient CPU. In 
message state, however, the device formats all output text. Each 
TYPE command argument initiates a new message. Thus, TusA,B;! 
generates three messages; one for A, one for B and one for the 
!, Similarly, TeusA@B,! generates two messages; one for A@B, and 
one for the !. In an output message, the "!" is transmitted as 
a separate message. The device passes the ASCII code for 
Carriage Return (octal 15 or decimal 13) to the application 
program running on the other CPU. The programmer should not, 
therefore, use the "!" as a message terminator when the driver 
is in message state. 


e. Message Transmission Count 


The $X System Variable is used to report the current message 
number when the driver is in message state. The message count 
is incremented by 1 each time that a message has been 
successfully transmitted and acknowledged. The count can have 
a value in the range 0 - 17g (or 1519). When the upper limit 
is reached, the count is automatically reset to 0. The user 
should first examine $X in order to determine if a transmission 
has been received correctly in message state. If its contents 
have been incremented by one since it was last checked, the 
transmission was successful. If its contents have not changed, 
and if bit 15 of the SA (see below) is zero, then the trans- 
mission is currently under way. If the contents of $X have not 
changed and if bit 15 of $A is set, then the transmission was 
not completed and bits 8 - 10 of $A will indicate the exact 
nature of the error. 


3.7.6.5 Error Conditions - MUMPS reports the error conditions 
associated with a CPU device in the SA System Variable after the 

I/O operation is requested. Table 3-7 lists the bit assignments for 
SA. 


The low byte of SA is meaningful only if the driver is in message 
state; it contains the number of unsuccessful transmissions which 
occurred before a successful one was achieved. This byte can provide 
a rough indicator of the quality of the communications link between 
the two CPUs. 


The high byte of SA represents the driver error status byte. If the 
high bit of SA is not set, then no errors were encountered and the 
latest transmission can be assumed to have been successfully completed. 
If, however, the high bit is set, then the other bits in the high 

byte can be consulted to determine the exact nature of the error. The 
contents of SA remain intact until the driver processes the next 


I/O for that device. 


Table 3-7 


CPU-CPU Device SA Bit Assignments 


Unsuccessful transmission. Message state only. 


Correct message too large Messages are limited to 

for buffer. 72 characters in message 
state, and 80 characters 
in terminal state. Any 
lines longer than these 
maximum values will be 
ignored. 


Synchronization error In message state, the 
synchronization of appli- 
cation programs is strictly 
the responsibility of the 
users. If both sides of 
the communications link 
attempt to transmit data 
simultaneously, an error 
message is sent to the job 
that initiates output when 
input is active. In 
terminal state, the driver 
observes the usual MUMPS 
conventions for transmission 
priority (i.e., if output 


is active input is ignored). 


Maximum number of retries Bit 10 is set to indicate 

exceeded that a message was sent 8 
times without reception of 
an acknowledgment (ACK). 


NOTE 


A situation in which bits 
O-7 and bit 15 are set 
indicates that retries are 
still in process. A 
maximum time of 10 seconds 
elapses between retries 
when there is no response 
from the receiving end. 


Unused 


CPU driver error indicator Bit 15 is set whenever an 
error occurs in the I/O 
operations of the CPU 
driver. 


3.7.6.6 


a) 


b) 


Cc) 


S&S 
e 
Gees 
we 
0 
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Examples - 


The following MUMPS command line would send a message to the 
remote CPU, wait for a response, and type the response on 
the system console. The CPU-CPU device number is 10 and the 
driver is in the message state. , 


1.OleuAnwlO:—2euTewe" TYPE IN A NUMBER" ResXesAculewTows! ,X 


The following command line would place the driver in 
terminal state and transmit the integers from 1 to 100: 


1.O01esAe 10: Ons FPeuT=1:1:100exT I, ! 
The following example shows how one MUMPS system might 


Sign-on another MUMPS system and start an application 
program. 


MACH. #1 MACH. #2 

Contains program PG1 Contains program PG2 

(listed below) under (listed below) under 

UCI #2 (EDP). The UCI #4 (USR). The 

CPU-CPU device is #6. CPU-CPU device is #4. 

SIGN-ON FOR CPU DEV 86.1 3PG2 START CPU- @U I/0 

P 33 SEND CTRL/C 1.81 A 43-.01 T!,°HI THERE’ 
SG ,UCI; GET TEXT 1-82 3;@U- CPU INTERACTION 
="MUMPS-11,ETC.” 1.83 sCOMMENCES, RELATIVE TO 
="UCI:" 1.94 sWHAT THE APPLICATION 
USRs PG2" ,! 1.95 sQONVENTIONS ARE, STARTING 
-.@1 R TXT: 6@ 1-86 sAT LINE 1.6 OR 1.7 OF 


TXT="" 3 ERROR IF NULL 1.87 3;PG1 IN OTHER CPU 
e, ETC, 


3.7.7 Sequential Disk Processor 


3.7.7.1 General Description - The Sequential Disk Processor (SDP) 
allows the user to physically access the disk as an ASSIGNable 
sequential I/O device. The SDP can only access disk space that is 
explicitly set aside for its use; other disk space, including global 
data base, cannot be accessed. Disk space for SDP use is allocated 
by the SDP System Utility program described in the MUMPS-11 Operator's 


Guide. 


SDP allows the user to impose any file structure on his SDP 


disk space that he wishes to implement. Each SDP ‘device' (up to 4 
can be used) requires one 256-word buffer from the system's buffer 
pool when ASSIGNed. SDP transfers disk data in 256-word blocks to or 


from a buffer to permit access of any block or byte within a block. 


I/O operations using the SDP are similar to DECtape I/O. The SDP 
anticipates two kinds of ASSIGN: explicit or implicit. The explicit 
ASSIGN tells the SDP driver specifically which device, which disk type 
and block, and which byte within the block to begin the I/O operation. 
The implicit ASSIGN is used subsequent to an explicit ASSIGN and 
assumes sequential addressing through the allocated disk space, begin- 
ning at the disk location currently pointed to for that device. 

Hence, if a MUMPS program using an SDP device accesses the disk in an 
indexed or random manner, each previous I/O operation would provide 
some type of key information which, in turn, would be presented as an 
explicit ASSIGN prior to the next I/O operation. Similarly, a MUMPS 
program may access the disk in a sequential manner; once the beginning 
disk block address had been requested in an explicit ASSIGN, each 
subsequent ASSIGN would be implicit, referring only to the device 
number, and the SDP would access blocks continuously until the MUMPS 
program terminated I/O, or until an attempt was made to exceed the 


allocated SDP space. 


nve, = Device number (59-62) 
nve, = Byte within block (0-511) 


nve, = Disk block address 
The Disk Block Address can be calculated by the formula 


TYP*2,097,152+ (UNT*262,144) +BLK 
Where: 


TYP = 0 for RK drives (RKO3 or RKOS) 
RM, 
1 for Re orf arives (RKO6, RS11, or RSO4) 
RS 
2 for RP drives (RP02 or RPO3) 
3 for RJ drives (RP04, RP0O5, and RPO6) 


UNT Disk unit # (0-7) 


BLK Block # on unit 
O-N where N = 4,799 for RKO5 
) 1,023 for RF11 
2,047 for RSO4 
26,928 for RKO6 
39,999 for RPO2 
79,999 for RPO3 
170,543 for RPO4 or RPO5 
341,086 for RPO6 


When a user's program issues a READ or LOAD command, SDP reads from 
the disk beginning at the disk block address specified in the ASSIGN 
command. SDP transfers data to the current user's partition line 
buffer until a logical EOM or until the line buffer is full. If an 
EOM is not detected or the line buffer is not full and the 256-word 
buffer boundary is reached, SDP reads the next contiguous disk block 
and transfer continues from byte 0 of the new 256-word block. 


When the user's program issues a WRITE or. TYPE command, SDP writes on 


the disk according to the following conventions: 
e the transfer of data will exceed the size of the buffer, 
e the device is UNASSIGNED, 


@ prior to a read, when the previous operation to the disk 
block was an output which did not exceed the 256-word 
buffer boundary. 


When SDP writes a block because the output exceeds the size of the 
256-word buffer, the SDP reads the next contiguous disk block into 
the 256-word buffer after the write, and continues the transfer into 
the 256-word buffer at byte §. 


When a job requests an I/O operation the SDP transfers data beginning 
at the specified byte within the block and continues from that 
block to each contiguous disk block until: 


@e aonull byte is detected, 
e the next contiguous disk block is not allocated to SDP, 


@e the physical limit for one unit of the disk type being 
accessed is reached. 


SDP requires that the MUMPS program detect these conditions and 
perform the logical operation desired at the MUMPS program level. 
This gives the MUMPS user full control of the disk access being 
requested and allows for the implementation of any access alcorithm 
the user might desire. | 


3.7.7.2 Device Numbers - The device numbers 59-62 are reserved for 
use by the SDP driver. Each device number is associated with a 
control block, resident in memory. The disk type and unit to be 
accessed are determined by the number provided inthe explicit ASSIGN 
syntax as 'nve,!'. On each explicit ASSIGN, information regarding 
the disk block being requested is initialized in the control block. 
On each implicit ASSIGN, information regarding the disk block being 
requested is obtained from the control block. On each UNASSIGN the 


information is set to zero, 


Once an ASSIGN is granted, no other user is permitted to affect the 
user control block pointed to by the device number until ownership 
is released with an UNASSIGN. 


Once use of a disk block is granted, no other SDP user is permitted 
to affect the block until the block is free again. It may become 
free by the accessing of another block or by UNASSIGN. 


3.7.7.3 Applicable Commands - 


OUTPUT 
WRITE 
TYPE 
INPUT 


READ 
LOAD 


3.7.7.4 Special Characters and Functions - SDP reports the disk 
block address of the block currently in the 256-word buffer in the 


SA system variable as an integer after each ASSIGN or I/O operation. 


SDP reports the byte within the disk block where the next I/O 
will begin in the $B and S$H system variables. A disk block can 
be pictured as two pages, each of which is 256 bytes long (§-255). 
The $B variable will report the address in the page and the $H 
will report the page (0 or 1). The equation ADR = $H*256+SB 

can be used to determine the byte address within the 5l2-byte 
(256eword) block. 


3.7.7.5 Error Conditions - In the explicit ASSIGN of an SDP device, 

a 'MXNUM' error is generated if the ‘nve, | (byte within the block) is 
greater than 511 and a 'MINUM' error if the nve, is less than @. Speci- 
fication of a disk block address (nve,) which does not exist will re- 
sult in a DKHER error. To test whether an existing disk block has been 
allocated to an SDP file, however, the SA system variable should be 


examined. 


The SA system variable contains access code violations that occur 
during an ASSIGN or I/O operation. SA is set to -1 (all bits set) 
if the disk block address requested has not been allocated for 
use by the SDP. The error can occur on an explicit ASSIGN and 
during the logical overflow from one contiguous block to the next. 


SA is set to -2 (all bits on except bit 0) if, during the contiguous 
access of the next disk block, the physical end of the unit is 


reached, 


The $A access violation errors do not destroy any SDP user control 
block information. The MUMPS program should examine SA after each 


assign or I/O operation to detect the result of a requested access. 


Examples: 


2e9l I G$A/19G&.01 T!,” BLOCK NOT ALLOCATED” 
2el3 I $A/108&.02 T!,” END OF PHYSICAL DISK UNIT" 
3.7.2 In Core Toh Communication 


3.7.8.1 General Description - In core job communication permits jobs 
to send information to other jobs without having to use the disk. 
Communication occurs through a series of pseudo-devices which occur 
in pairs; even-numbered devices are "transmitters" and odd-numbered 


devices are "receivers". 


To send information, a job ASSIGNs a transmitter and outputs a message. 
Another job ASSIGNs the corresponding receiver and reads the message. 
Transmission occurs through an intermediate 64-character ring buffer 
which is permanently attached to the device pair. Transmission is 
fully buffered; i.e., messages may be output whether or not the cor- 


responding receiver is ASSIGNed, and READS may be issued whether or 


not the corresponding transmitter has output any messages or is even 
ASSIGNed. Furthermore, several jobs may ASSIGN a particular trans- 
mitter, output a message, and UNASSIGN the transmitter before earlier 


messages are read through the receiver. 


An attempt to output characters after the buffer has become full will 
Suspend the output job until the receiver has removed one or more 
characters. Similarly, an attempt to read characters when the buffer 


is empty will temporarily suspend the input job. 


The transmitter is output only and the receiver is input only. An 
attempt to receive input from a transmitter will result ina null 
string being returned; an attempt to output on a receiver will have 


no effect, and the job will continue as if output has occurred. 


3.7.8.2 Device Numbers - 


Number Device 
112 Transmitter for Unit @ 
113 Receiver for Unit @ 
114 Transmitter for Unit l 
127 Receiver for Unit 7 


3.7.8.3 Applicable Commands - 


Output 


TYPE 
WRITE 
PRINT 


Input 


READ 
LOAD 


a) TYPE and READ 


Every argument of the TYPE command by the output job 
corresponds to an arcument of the READ command by the 
input job. The data that is received is thus an image 
copy of the transmitted data. For example, execution 
of the following code will result in A="HELLO", 
B="AGAIN", C=carriage return/line feed characters. 


>AumlL2uesTow HELLO" ,"AGAIN", tenpAeuwl] 3a ypRawA,B,C 


b) PRINT 


In general, arguments of the PRINT command are treated the same 
as arguments of the TYPE command. However, a "PRINT 1" has the 
special control effect of resetting the buffer to an empty con- 
dition. It is thus possible for a program to insure that an in- 
put job will not receive residual data left unreceived by an 
earlier program. "PRINT 1" may be issued to the transmitter or 
the receiver of the incore job communication device. 


3.7.9 DMC-11 


3.7.9.1 General Description - The DMC-11 microprocessor is designed 
to provide for effective computer-computer communication thus permitting 
data base networking. Although it serves the same function as the 


CPU-CPU handler, it is more effective because: 


@ The microprocessor (DMC-11) handles all the line protocol 
including cyclic redundancy calculation, acknowledge/not 
acknowledge, retransmission, message sequencing. 


® It is a direct memory address (DMA) device thus freeing up 
all CPU time until all messages are received/transmitted and 
fully checked. 


A MUMPS system may not have both a CPU-CPU and a DMC-1l1 handler. Early 
experience suggests a limit of 4 DMC's due to both space and bus loading. 
Each DMC requires 256 words of buffer space and 128 words of scratch 
space in main memory. Data is exchanged a message at a time where the 


maximum message length is 132 characters. 


3.7.9.2 Device Numbers - The DMC's will be assigned numbers in the 
range 4-19 and will be in sequence after DC's, KL's, DL's and non- 
standard devices. The actual device numbers are determined at SYSGEN 


time. The user must also provide vector and hardware address. 
3.7.9.3 Applicable Commands 


OUTPUT | INPUT 
TYPE/PRINT READ 


3.7.9.4 Error Conditions - Error conditions will be reported by the 
system variable, $A. Error statistics can also be derived from the 
scratch memory used by each DMC. A precise layout of this region and 
the SA variable will be published in future release notes. 


CHAPTER 4 
LIBRARY UTILITY PROGRAMS AND GLOBALS 


This chapter describes the facilities provided to the MUMPS pro- 
grammer by the Library Utility Programs and Globals. Section 4.1 
describes the Utility Programs; Section 4.2 discusses utilization 


of Library Globals. 
4.1 LIBRARY UTILITY PROGRAMS 


Library Utility Programs are listed in the Program Directory of the 
System UCI (UCI #1) and may be modified only by programmers having 
access to the system via that UCI and the PAC. These programs are 
accessible ina ‘'run-only' state for all users of the system, regard- 
less of UCI. The naming convention which states that a Library 
Utility program name begins with the percent symbol (%) allows for the 
distinction between the utilities and all other programs filed under 
UCI #1 that are not accessible via other UCIs. | 


4.1.1 Features 


The Library Utility Programs supplied with the MUMPS=-1l1 system 
satisfy some of the basic needs of the MUMPS applications program- 
mer’, Four of the programs currently provided, %T, %D, %OD, and 

$IO, are subroutines which can be called from other MUMPS programs. 
The remaining programs provide the capability for performing logical 
backup and restoration of program and global files as well as the 
ability to examine Program and Global Directory contents, and logical 


global structures and contents. 


The Library Utility Programs and their features are summarized below. 


‘Special System Utility Programs, which are available to the System 
Manager and operator only, are described in the MUMPS-11 Operator's Gutde. 
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Program 


Description 


Subroutine to format the date kept in the $D 
System Variable for output to the currently 
ASSIGNed output device. 


Program to provide a brief directory listing 
of the programs stored under the current UCI. 


Programs to provide a directory listing of the 
globals filed under the current UCI. 


Program to list the logical structure and data 
of specified global files. 


Program to restore globals saved by %GS to the 
directory of the current UCI. 


Program to save global files, listed in the 
Global Directory of the current UCI on paper 
tape, magtape or DECtape. 


Program to list global nodes, their locations, 
levels, data types and contents for the current 
UCL. 


Program to analyze a global; gives the number 
of nodes, total bytes, bytes per block and 3% 
utilization for each data type, for system 
overhead and for each free area in a global. 


Program to dump a global disk block as seen by 
the system; prints the subscript, pointer, data 
type and data for each node. 


Subroutine to assign a specified I/O device, 

if available. Upon return from this routine, 

an IF command with no arguments may be used to 
determine whether the device was assigned (TRUE) 
Or waS not assigned (FALSE). 


Program to display the message "IN USE" on the 
currently assigned device. 


Program to convert octal or decimal values to 
their decimal or octal equivalents. 


Program to allow a terminal user to send 
messages to the console terminal. 


Program to list the contents of the current 
UCI's Program Directory. 


Program to restore user programs to the cur- 
rent UCI's Program Directory using a tape 
created by %PS. 


Program to copy any program listed in the 
program directory of the current UCI toa 
specified output device. 


Program Description 


$T Subroutine to format the time of day kept in 
the $T System Variable for output to the cur- 
rently ASSIGNed output device. 


4.1.2 Developing and Filing Library Utility Programs 


Although DIGITAL supplies a number of Library Utility Programs, each 
installation will probably require additional programs to suit its 
particular applications. Library programs are no different from 

other MUMPS programs except that they may use the VIEW command and 
SVIEW function. This means that a program must be completely debugged 
before incorporating it into the system, since the integrity of the 
entire system can be seriously affected by the careless use of VIEW 
and SVIEW. 


Another difference is external and results from the way Library Utility 
Programs are named and filed. By employing a special naming convention 
in which the percent character (%) is always used as the first character 
of a Library Program name, these programs can be uniquely identified 

by the operating system. To file a Library Program, the System 

Manager simply logs-in to the system with the System UCI and the PAC, 
issues a PRINT,,1024 command and a 'FILEgyprogram name’ command. The 


filed program is then accessible to all system users. 
4.1.3 Running Utility Programs 


This section describes the common operating characteristics of the 
various utility programs supplied with .the MUMPS-1l system. Except 
for the %T, %D, and %1IO subroutines, all Library Utility Programs 
are completely interactive and provide the user with complete text 
messages. Loading procedures are similar for each program 

as are the methods of error procesSing. By convention, Part @ of 
each MUMPS System Utility Program contains a complete description 
of the program for user reference. 


4.1.3.1 Starting Programs - There are several methods by which 
Library Utility Programs can be loaded and started. 


a. Any user who has logged-in to the system using 
the Programming Access Code (PAC) may CALL a program: 


>CALL ZPD causes the Dtrectory Lister 
to be loaded and started. 
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b. Programs can also be loaded usSing the log-in syntax: 


CTRL/C 


MUMPS-11 V3B #6 


UCI: JOC: AGL Loads and starts the Globat 


Listing Program 


Library subroutines including %T, %D, %OD, and %IO can be 
called by other programs using either the CALL or the 
OVERLAY command. The other utility programs could also be 
loaded this way but except for very specific circumstances 
it would make little sense. For example: 


1.03 C 2D T”™ " C&T T I!,"THIS PROG..." causes the Date and Time 
to be output to the eur- 
rently ASSIGNed devtece, 


>D_1 followed by the message 
4 OCT 73. 11:31AM 'TuTS PROG " 


THIS PROG.e.e 


4.1.3.2 Stopping Programs - A program's operation can be terminated 
at any time by either typing CTRL/C or depressing the BREAK key, 
provided that this feature is enabled!. If this is done while the 
program is processing some data, or while I/O is in progress, the 
user can be reasonably certain that the results produced are at 

best incomplete. In any case, the program cannot be restarted from 
the point of termination and must be either reloaded or started by 

a Direct Mode DO Command referencing the Step or Part which begins 


the program. 


4.1.3.3 Error Detection and Recovery - Errors which occur during 
program operation are typing errors, program detected errors, 
or system errors. 


Typing Errors - A typing error can be corrected, 
prior to line termination, by using 
RUBOUT to delete a single character 
or CTRL/U to delete the entire 


line. 
Program - All MUMPS Library Utility Programs per- 
Detected form error checking to assure the validity 
Errors of user responses. When an error occurs, 


the program types an appropriate message 
and waits for the user to type a correct 
response. 


system - System error processing and messages 
Detected are discussed in paragraph 2.15 and 
Errors Appendix C. 


lRefer to ASSIGN command in MUMPS-11 Language Reference Manual. 
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4.1.4 Library Utility Program Descriptions 


The paragraphs which follow describe the functional operation of the 
Library Utility Programs. Detailed descriptions of operations are 

not given since all programs use similar loading and error process- 
ing techniques. Further, these programs tend to be highly interac- 
tive and normally contain lengthy text messages of explanation. 
Details are provided here only if the program does not provide the in- 
formation. 


4.1.4.1 Calendar Date Subroutine (%D) - The %D subroutine formats 
the representation of the calendar date contained in the $D System 
Variable and outputs this value to the currently ASSIGNed output 
device. The calling program must perform all desired page for- 
Matting (see paragraph 3.5). The date is output in the form 


shown below: 


day of month (1-81) | 
name of month (JAN, FEB, ete.) 
year count minus 1900 (for 
1974, yy = 74) 


dd mmm yy where: dd 
mmm 


Example: 


The following command line outputs the current date 
on the 30th line of a page, 35 spaces from the left margin: 


34.98 TYPE # F I=l:1:29 T !? 
34.99 TYPE 1735 C ZD 


4.1.4.2 Fast Program Directory Lister (%FD) - The %FD program gives 
the user a brief (name only) listing of the programs filed under his 


UCI, on the currently assigned (calling) terminal. 


4.1.4.3 Global Directory Lister (%GD) - The %*GD program lists the 
names of all the globals listed in the Global Directory of the current 
UCI. Either the calling terminal or the line printer may be selected 


as the output device. 


4.1.4.4 Global Lister (%GL) - The %GL program allows the contents 

of one or more global files, listed in the Global. Directory of the 
calling program's UCI, to be listed on the line printer or calling terminal. 
The program facilitates the development and debugging of globals 

by providing not only a listing of the data outlined therein, but 

also a graphic representation of the logical structure itself. 


Once the last response has been typed, the program initiates the 
listing operation on the specified output device. The listing 
output contains the subscript for each node as well as the 


data value. The format of the listing is shown in Figure 4-1 
below. 


level of subseripting 
level of subsertpting 


level of subsertpting 
level of subsertpting 


subsertpt value at gtven level 
data value of the subsertpt 


Figure 4-1 %GL Output Format 


When the current listing operation is complete, %*GL restarts, if the 
'S' option (list selected globals) was selected, and requests another 
name. If no further globals are to be listed, the program can be 
terminated by typing a Carriage RETURN in response to the request for 
another global name. If the program was operating under the 'A' 
option (list all globals), termination automatically occurs when all 
globals have been listed. 


For example, if the structure and contents of global A were as shown 


in Figure 4-2, the output listing of %GL would appear as shown in 
Figure 4-3, 


(1,1) (1,2) (1,3) (1,4) (2,1) (2,2) (2,3) (2,4) 


(4,354). -61,3,2) 


11-1448 


Figure 4-2 Example Global Layout 


END OF LISTING 


Figure 4-3 Example of %GL Output 


4.1.4.5 Global Restore (%GR) - The %GR program restores the global 
files residing on DECtape, magtape, or paper tape to the disk under 
the Global Directory of the UCI of the calling terminal. The pro- 
gram accepts only tapes created by the %GS program. When DECtape or 
magtape is used, the tape must be mounted on the selected unit of the 
appropriate drive. As each global file is restored, its name is 


output to the calling terminal. 


4.1.4.6 Global Save (%GS) ~- The %GS program permits all or selected 
global files listed in the Global Directory of the calling termi- 

nal's UCI to be saved on DECtape, magtape or paper tape. If globals 

are to be saved on DECtape or magtape, mount the tape on an appropriate 
drive. The save operation begins at the beginning of the tape (address 
@ for DECtape). As each global is saved its name is output to the call- 
ing terminal. 


4.1.4.7 Global Trace Program (%GT) - The %GT program traces down 
each node of all or selected globals contained in the current UCI, 
and produces a listing on the line printer or currently assigned 
device. The-listing indicates the physical level, the block address 
in decimal, and the contents and data type of each node, in the 


format. illustrated by the example shown in Figure 4-4. 


GLOBAL NAME? AEC 


NODE LEVEL TYFE BLOCK # CATA 


BC 


4494605 THIS 1S A GLOBAL 
4495359 ABC 
4195433 
41495407 
4495472 
44952306 
4495359 
4495443 
4195443 
4495447 
44952359 
4495453 


A 
1 
z 
4 
2 
2 
2Z 
BI 


OW & hy 
t.l P33 ge le) bed 3 cs de ted 3 


Mh BIA h em HTH 


Figure 4-4 Sample Global Trace 
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The program is useful for locating the cause of a corrupted data base. 
If the Disk Block Tally program (described in the MUMPS-11 Operator's 
Guide) does not show any discrepancies in the disk block structure, 
the user may check his globals by calling this program. The block 
address is given in decimal so that it may be used with the SVIEW 


function. 


4.1.4.8, Global Utilization Program (%GU) - The $GU program allows the user 
to analyze a global. This can be helpful in determining if a global has 
been designed efficiently. %GU will request a global name which should 
be entered without the preceding + (up arrow). A listing is produced 
which contains the number of nodes, total bytes, bytes/block, and % 
utilization for system overhead, and for each data type and free area 


in a global. For the format of the listing, see Figure 4-5. 


4.1.4.9 Global View Program (%GV) - The %GV program dumps a global 
disk block as seen by the system, and prints a listing containing the 
subscript, pointer, data type and data for each node, as shown in 
Figure 4-6. This program is very useful in locating the cause of a 
corrupted data base. When called, *GV will ask for a global reference 
which can be either a global node name, or the MUMPS block number in 


decimal. 


4.1.4.10 I/O Device Assignment Subroutine (%1I0) - The %IO subrou- 
tine permits the user to assign an I/O device and still retain 
control, even if the device is not available (unlike the operation 
of the ASSIGN command). Before calling %1I0, the user must create 

a variable called #10 and assign to it the number of the device 

to be assigned (e.g., SET %10=3, specifies the Line Printer). The 
program uses the IF command described in the MUMPS-11 Language 
Reference Manual to set an internal condition which may be tested 
by the programmer. If the device assignment is successful, the 
internal condition is set to TRUE (-.01). If the assignment can 
not be made (device is busy or nonexistent), the internal condition 
is set to FALSE (0). In either case, control is returned to the 
calling program. To test the status of the device assignment, the 
program should use an IF command without arguments or an ELSE 


command following the %1I0 call. 


GLOBAL REFERENCE: “SYS¢41) 
GLOBAL DUMP OF DISK BLOCK: 4194416 
OFFSET: 256 CONTINUATION BLOCK: @ 


SUBSCR. FOINTER $ 
“CL 


WEE QDADEeEM NA AA QDMA QA VWAE AMM Nee SS pr: 


Po 4D 


“J 
8 
3 
re 


QS VQ Q QO Aw s tal 


3216 
14 

46376 
49351 
Ss6216 


¥) 
é 
1 
1 
1 
uf 
z 
é 
2 
1 
4 
z 
1 
2 
1 
1 
1 
1 
1 
4 
1 
1 
1 
é 
1 
1 
1 
1 
2 
1 
G 
4 
1 
- 
1 
1 
1 
A 
- 
4, 
1 
1 


oa 


Figure 4-5 Sample Global View Dump 
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Example: 


The following program attempts to assign the paper tape punch. 
If the paper tape punch is busy, the program types BUSY and 
quits. 


A.43 SET 21022 C 210 ELSE TYPE !,"BUSY" Q 


C 2GU 


GLOBAL NAME SiS 
GLOBAL UTILIZATION FOR SYS 


TOTAL NUMBER OF BLOCKS 5 TOTAL NUMBER OF NODES #5 


NO OF NODES TOTAL BYTES BYTES/BLOCK # UTIL 
SYSTEM OVERHEARD 
SINGLE NUMERIC 
STRING 

DOUBLE NUMERIC 
FLOATING POINT 
FREE AREA 


. 68 
. 26 


Wm co On oy 
" b> ON bat 


“J 
f. 


GLOBAL NAME 
5 


Figure 4-6 Sample Global Utilization 


4.1.4.11 IN USE Message Program (%IU)- The %IU program displays the 
message "IN USE", followed by the date and time, on the currently 
ASSIGNed device. This is a means of warning other users that a 


seemingly idle terminal is in use. 


4.1.4.12 Octal/Decimal Conversion Program (%OD) - The %OD program 
converts integer octal values to their decimal equivalents or converts 
integer decimal values to their octal equivalents. When the program 
starts, it checks for the existence of a variable called "30D". If 
the variable is defined, its contents are taken as the number to be 
converted; if OD is a string variable, the program assumes it is an 
octal number and reports its decimal equivalent in the %0OD variable. 
If OD is a numeric value, the conversion program assumes it is a 


decimal number and reports its octal equivalent in the %OD variable. 


Examples: 


9.27 S 70D=123 C 20D T 20D (the octal number 173 ts TYPEd on 


| the currently asstgned device) 
3.45 S 70D="123" C 20D T 20D (the decimal number 83 ts TYPEd on 
the currently asstgned device) 


If the OD variable is not defined, the program will operate inter- 
actively with the terminal user. The program prints an asterisk (*) 

to request that the user enter a number for conversion. If the number 
is preceded by an "0", the program assumes octal to decimal conversion. 
If the number is preceded by a "D", decimal to octal conversion is 
assumed. To stop the program, the user presses RETURN key when another 


value is requested. 


4.1.4.13 User to Operator Communicator (%0P) - The %OP program allows 
a terminal user to communicate with the system operator at the console 
terminal (device number 1). Communication can be established only if 
the console terminal is not in use. To improve the readability of the 
messages, the program encloses messages being sent in double angle 

brackets (<<message>>) , messages being received in triple angle brackets 
(<<<message>>>), and messages being sent by %8OP itself in single angle 


brackets (<message>). 


The program begins operation at the user's terminal by printing two 
left angle brackets (<<) to signal the user that it is ready to accept 
a message. Messages are sent one line at a time; each message is 
terminated by a Carriage RETURN. %OP notifies the user when a message 


is received at the console terminal by printing: 

<OPERATOR NOTIFIED> 
The program then waits for the operator to reply. 
Messages received at the console terminal are prefaced by a preamble 
consisting of the.current time and the calling terminal's device 
number. The operator can respond to a message by typing: 

@® a responding message 


e Carriage RETURN only (null message) 


e cCTRL/C to terminate program operation 


If the operator types a responding message, the program sends it to 
the user, then waits for a reply. If a null message is typed, the 
program sends the message: 


<OPERATOR'S ANSWER WAS NULL> 


to the calling terminal, then waits for the user to reply. The user 
can type:’ 


@e another message to continue the communication 


@e Carriage RETURN only, or CTRL/C to terminate communication 
If the console terminal is in use, %OP sends the message: 
<OPERATOR BUSY - PLEASE WAIT> 
to the calling terminal, then attempts to send the message at 
5-second intervals. ,If the console terminal remains busy after 60 
seconds have elapsed, %OP sends the message: 
<OPERATOR STILL BUSY =~ TRY LATER> 
to the calling terminal, then quits. 


Example: 


The following example shows user/operator dialog while 
running %OP: 


User Dialog Operator Dialog 
> ° 
>C Z0P , 


<<PLEASE MOUNT MY MAGTAPE>> 


<OPERATOR BUSY ~ PLEASE WAIT> operator busy 

<OPERATOR STILL RUSY - TRY LATER> 

> ZOP , 

<<PLEASE MCUNT MY MAGTAPE>> >H 

<OPERATOR BUSY - PLEASE WAIT> EXIT 

<OPERATOR NOTIFIED> : <9:41AM MESSAGE FROM DEVICE NUMBER 6> 


<<<PLEASE MOUNT MY MAGTAPE>>> 
<<<GIVE NAME & SETUP STATUS>>> 


<<GIVE NAME AND SETUP STATUS>> 
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<<J., O° CONNOR - WRITE ENABLED>> 

<OPERATOR NOTIFIED> }}© <9:42AM MESSAGE FROM DEVICE NUMBER 6> 
<<<J, ("CONNOR - WRITE ENABLED>>> 

<<<0K, YOUR TAPE ON DRIVE 2>>> 


<<OK, YOUR TAPE ON DRIVE 2>> 


<<THANKS>> 

<OPERATOR NOTIFIED> <9:42AM MESSAGE FROM DEVICE NUMBER 6> 
<<<THANKS>>> 

<OPERATOR’'S ANSWER WAS NULL> 
<<>> 


<<>> 


4.1.4.14 Program Directory Lister (%PD) - The %PD program lists the 
contents of the Program Directory of the current UCI. Either the 


calling terminal or the line printer can be selected as the listing 
device. 


The directory listed output by PD is in the format shown in 
Figure 4-7. 


PROGRAMS FILED FOR YOUR UCI DATE TIME 


PROGRAM NAME LENGTH DISK BLOCK 


MMMM NNNNNNN 


one to three-character program name 
disk bloek on whieh the program begins 
program tength in words 


Figure 4-7 SPD Output Format 
When the listing is complete, %PD exits automatically. 


4.1.4.15 Program Load (%PL) - The PL program allows programs resid- 
ing on DECtape, magtape or paper tape to be loaded into the system 
and entered in the Program Directory of the current UCI. The program 
accepts only input tape which was created by the %PS program. 


Before loading %PL, the user must observe the following prerequisites: 


a. The user must have logged-in to the system, using 
the PAC. 


b. If the program being input are library programs, the 
user must log-in to the system using the System UCI 
code and the PAC. 


c. When DECtape is used, the starting address of the 
programs to be restored must be specified. This 
is the address that was originally specified to 
the %PS program when the programs were saved. 


During operation, the program prints the name of each program restored 


at the calling terminal. 


4.1.4.16 Program Save (%PS) - The %PS program allows either selected 
programs or all programs residing in the Program Directory of the 
calling program's UCI to be saved on DECtape, magtape, or paper tape, 
or to be listed on the terminal or line printer. Before loading 

2PS, the user must have logged-in to the system using the PAC. When 
DECtape or magtape is used the tape must be mounted on drive @ of the 


tape. unit. 


During operation, %PS prints the name of each program on the calling 
terminal. If the programs are saved on DECtape, remember to save the 
starting address specified in response to the program's question: 
"WHAT IS DECTAPE STARTING ADDRESS?". This address must be used when 
restoring the programs to the disk via the @PL program. The %PS 


program does not allow multi-reel saves. 


4.1.4.17 Time of Day Subroutine (%T) - The %T subroutine formats 
the current time of day value contained in the $T System Variable 
and outputs this value to the currently ASSIGNed output device. 

The routine does not perform any page formatting (i.e., tabulating, 
indenting, etc.) This must be done by the calling program's use 
of the standard format control characters: ae and ?nve . 


The time is output in the following form: 


hh :mm| | M where: hh = hours (f-12) 
mm = mtnutes (f-59) 


Example: 
Assume the time to be half-past four in the afternoon: 


1.06 TYPE #720,"THE TIME IS: " C ZT 


Execution of the above line results in the output of a FORM Feed 
followed by a tabulation of 20 spaces from the left margin, followed 
by: 


THE TIME IS: 4:32 PM 
4.2 LIBRARY GLOBALS 


Library Globals are like other globals in the MUMPS—-1l system except 
that they can be read by all UCI users. Library Globals permit the 
MUMPS applications programmer to create common data bases for in- 
formation retrieval between different UCI's and their associated 
application systems. Library Globals use the same naming scheme as 
the Library Utility Programs (i.e., % is the first character in the 
name) and are afforded the same type of protection (i.e., they can 

be modified only by the System UCI user). All globals are referenced 
in MUMPS commands using the up-arrow prefix (* or +t). 


4.3 THE EDITOR 
4.3.1 Introduction 


The MUMPS-1l1 Editor supplies the user with an easy means of editing 
MUMPS-11l1 programs and globals. It enables the user to make all of 

the changes allowed by the MODIFY command and it also offers several 
other features, notably the ability to modify globals, perform searches, 
and change every occurrence of a particular string within a program. 
Prior to using the MUMPS-11 Editor, the user should LOAD the program 

to be modified if it is not already in core. The Editor itself may 

be invoked by typing the following command (all user input is under- 
lined): 


The Editor will then output its prompting message and wait for the 


user to enter a command 
EDIT: 
The following sections describe the various editing options available. 


Note that entering a null command in response to the Editor's prompt 


will return the user to direct mode. 


4.3.2 Editing Program Lines 


4.3.2.1 General - The instruction for editing a single program line is 


of the following general form 


EDIT ty SPNo/, Rua} ENDL aSVe, 


In the above example, SPN specifies the step to be changed, sve, pin- 
points the characters”to be replaced (R), and sve. defines what sve, 
will be replaced with (W). 


As an example, suppose that in the following line 
Le leuwTew! "HERE IS AN EXAMPLE" 


the "IS" is to be replaced with "WAS". The instruction needed to ac- 


complish this change is 


EDIT? uy] eo) 24 Ris lSie/ ey WiWAS 
1. leoTeo! "HERE. WAS sANLs EXAMPLE" 
EDIT: 


Note that after any editing command has been executed the MUMPS-11 


Editor echoes the new line and outputs its prompting message. 


The user may delete characters or add new characters to the beginning 
of a line by omitting sve, or sve,. Specifically, if sve, is null, 
will be inserted at the beginning of the specified step; if sve. 


will be deleted from the step. The following is an ex- 


sve 
2 


is null, sve, 


ample of how this can be done. 


2. SeuTew! "CHANGELUCHANGELUTHISHUuLINE" 

EDIT :uu2. 8 feed LX Seal weed od Ltd X 

2. Se uleuXeyTiw! "CHANGELUCHANGELUTHISLuLINE" 
EDIT :42.8./uRtsCHANGE we AuWi 4/7 

2. SeuleoXeuT cy! "CHANGFLuUTHISWUuLINE" 

EDIT: 


The user may also wish to add a string of characters to the end of a 


line. The END feature may be used to do this: 


16.35: 2.1 Moi) ears" 

EDIT: 18.354/ R END W ,A,B./ 
18.35 —T V)Xo¥-"eais" AyB 
EDIT: 


4.3.2.2 The Dot.Dot.Dot Feature - The dot.dot.dot feature of the 
MUMPS-11 Editor allows the user to modify lines with a minimum amount 


of typing. The command which incorporates this feature is of the form 


See ee) 
1 n 
EDITiwuSPNetuReWS,... ‘od uiysve, ./ 
ee 
n 
The Editor will insert sve. in place of the string of characters from 
the first occurrence of Sy to the subsequent first occurrence of Sn: 


To remove the SET clause from the step 
3. leuSeuX=SE(Y,A,10)euTeutA(3,4)esGew4 
the user might do the following 


EDIT :1.43.164,ReuSeuX=SE(Y,A,10) ela gWewl ./ 
3. leuTteutA (3,4) wwGuus4 
EDIT 


However, considerable typing time, and possibly typing errors, could 
be avoided by the use of the dot.dot.dot feature: 


BOTS e be RL gS et a ee We 


3. LleuTeutA(3.4)euGeud 
EDIT: 


Either Sy or S5 or both may be of length greater than one. Utilizing 


this fact can insure that the desired string is the one modified. For 


example, suppose the user wished to change the line 
4. le To! "THISMuTESTSuwTHEWuTERMINAL",X,Y 
to 
A.leuTeu! "THIS IS RIGHT",X,Y 
the command 
EDIT 104.124 Rul... LaasWesISeuRIGHT «/ 
would cause the line to read 
4.lesTSuuRIGHT",X,Y 
This could be prevented by instead typing 


EDIT :nu44. le puReouTE...LeuWeulSeuRIGHT _/ 
4.1 Teol"THIS IS RIGHT",X,Y 
EDIT: 


The user also has the option of omitting either Sy or Sn: If no start- 


ing point (S,) is indicated, the beginning of the line is assumed: 


5.3 S xX=3, Y=SE(Z,1,4) G4 
EDIT ra45.3 2/euRey..-3, Qed WW teed ted Pe, 
5.3 IewY=SE(Z,1,4) G 4 

EDIT: 


Likewise, omitting the ending point (S_) implies that the end of the 


line should be assumed: 


7.9 S M=N*P,Y=SE(Z,1,M) D 9 

EDIT :097.9 oy /tesRecaS « «nee Weg At Beta 9 ae’ 
7.9 § M=N*P,Y=AtB G 9 

EDIT: 


As in the general editing command, omitting sve, causes the string 


SyretS to be deleted. 


2 


6. 45uuSeuX=V+Z,R=S*Y¥ouTey! "THE RESULTING ANSWER IS", (X+R) 
EDIT 2146. 45etuR RE... oy a/uWo 4/ 
6. 45u4uSeaX=V+Z ,R=S*¥YeuTiu! "THELGANSWERWIS", (X+R) 


4.3.2.3 The AGAIN Feature - Frequently, several changes may have to 

be made to the same line. The AGAIN option saves the user from re- 
peatedly having to retype the step number of a line undergoing multiple 
changes. After the first modification has been made, an "A" may be 
typed in place of the step number. The Editor prints the step number 


before outputting its normal replace (R) request. As an example: 


19. 27 em Te SUMe Tes Rew l 4.97 

PDI 41979 LR] 22 cca 

19. 27euTeuSUMeuDesResQeul 4.97 
EDIT :. 4A _/ 0419. 27s RewQ_, Au WeuG ./ 
19.27euTeuSUMesDeuReuGeul4.97 3 
EDIT: 


4.3.2.4 The SEARCH Feature - By responding to the Editor's prompt with 
an S, the user can direct the Editor to search for all occurrences of 

a particular string of characters. If the Search feature has been 
specified, the Editor outputs a prompt (SEARCH FOR:) for the desired 
string, performs the search, and prints all lines in which the string 


occurred. As an example, consider the following: 


EDIT :uuS 2/ 

SEARCH FOR:uu “QRS ./ 

1.4 SeutORS (Q)=Q0+R*S 

2.6 SemR=R+leoTeoutORS (R)uuwCou7.2 
8.41 KeutORS 


4.3.2.5 The CHANGE EVERY Feature - The MUMPS-11 Editor gives the user 
the capability of changing all occurrences of a particular string with- 
in all or part of a program. To utilize this feature, the user should 


first type a "C" in response to the Editor's prompt. 


EDIT :auC / 


CHANGE EVERY :wuSVE, «4uTO:wuSVE, ./ 
FROM LINE: SPN, . tL sTHROUGHLGLINE wu SPN, =/ 
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In the interchange that follows, the user must specify the string to 
be changed (sve,), the string which is to replace it (sve,), and the 
range of lines (spn, through spn.) over which the chanye should be 


made. Note that if spn, is null, the modifications will begin at the 


1 


first line in the program; if spn. is null, the Editor will continue 


2 
through the end of the program. The Editor will echo each line that 


is modified. Suppose that in a program all references to program TST 


are to be changed to refer to program NEW: 


EDIT uC” 

CHANGE EVERY :euTST ./uTO:LuNEW «/ 
FROM LINE:wu2/:uTHROUGH LINE: 4/ 
3.2 S X=9,Y=A+B C NEW 

4.98 O NEW:3 


4.3.2.6 The RE-NUMBER Feature - By responding to the Editor's prompt 
with an R, the user can direct the Editor to renumber a line. The 
Editor outputs a prompt (LINE TO BE RENUMBERED:), and the user responds 
with a valid line number (spn,). The Editor then outputs the prompt 
(NEW LINE NUMBER:) and the user responds with a second line number 
(spn) that does not currently exist in the program. The line speci- 
fied by spn, is then renumbered to spn. and the old spn, is erased. 


EDIT: wiRs/ 
LINE TO BE RE-NUMBERED: wuspn)./ 
NEW LINE NUMBER: wispn5—</ 


4.3.3 Editing Globals 


The MUMPS-1ll Editor can also be used to edit globals consisting of 
string data. The procedure for editing global data is the same as the 
procedure for editing a single program line except that a full level 
global reference, rather than a step number, is the proper response to 
the computer's "EDIT:" prompt. Note that the "END", "AGAIN", and the 
"dot.dot.dot" features of the editor apply both to program steps and 
global nodes (see sections 4.3.2.1, 4.3.2.2, and 4.3.2.3). 


As an example of editing a global node, assume the following qlobal 


is defined: 


“LDP (3) ="TOWARELsEDLyBLDG" 


This node may be edited in the following manner: 


4.3.4 


EDIT +s UDP (3). Ks Ri sAR Pe sh De es We PReS 4/ 
“LDP (3) ="TOWERtsBLDG" 

EDIT seuAp_)° LDP (3)eu Reo. - Gata Wes INGLsINFERNO 2 
“LDP (3)="TOWERINGW4INFERNO" 

EDIT su A 2, LDP (3)uu Reo... T/e We THEW 
“LDP (3) ="THEwaTOWERINGawlNFERNO" 


Entering MUMPS-11 Commands from the Editor 


MUMPS-11 commands may also be executed from the Editor. This capability 


allows the programmer to perform calculations, examine and modify local 


and global data, and execute almost any command which could be invoked 


in direct mode, without having to leave the Editor. As an example, 


consider the following: 


>Dew *3 7 

EDIT :14 LewABCruWew3 7 

3.1 S x=3 K DG 

EDIT :e83. 14% Reu3.. Deu Wed, Y=CeuKiAB ,D-/ 
3. Lem SewX=3 ,Y=CouKuewAB,DG 

EDIT :w4FusABC./ 

EDITs.2 

> 


4.3.5 Summary of Editor Questions 


USER 


Dt+3_/ 


SYSTEM MEAN ING LEGAL RESPONSE 


EDIT: MUMPS-11 1. Null entry, exits to 
Editor direct mode. 
invoked 2. Line Number for editing 
a line. 
3. Global Node. 
4. "S" for Search. 
5. "C" for Change Every. 
6. "R" for Renumber. 
7. "A" for Again, which 
repeats previous EDIT. 
8. A valid line of MUMPS 
code. 


Step Number R Replace 1. A string of characters 
or Global ~/ string that derived from the program 


Node 


follows R or global node being 
edited. 
2. A string containing 
three consecutive dots; 
e.g., A...-B or C...0Or 
Ser 


USER 


Sra? 


Ca 


Rig 


Ae? 


SYSTEM 


SEARCH FOR: 


CHANGE EVERY: 


TO: 


FROM LINE: 


THROUGH 
LINE: 


LINE TO BE 
RENUMBERED: 


NEW LINE 


Previous 

Step # or 
Previous 
Global Node R 


ERROR MESSAGES 


J 
ey) 


TOO LONG 


MEAN ING 
3. 
4. 
String to Air 
replace R 2 
string 


entry will 
be searched 
for 


All occurrences 
of entry will 
be changed.... 


-.-to the 
following 


Lower limit i 
of CHANGE 22 
EVERY 

question 


Upper limit Le 
of CHANGE 2 
EVERY 

question 


This line wil 
will be re- 
numbered.... 
with this line. 


Allows re-edit 
of previous Step 


LEGAL RESPONSE 


The word END. 

A null entry; causes 
insertion at the be- 
ginning of the line. 


A string of characters. 
A null entry; causes 
the R string to be 
deleted. 


A string of characters. 


A string of characters. 


A string of characters. 


A Step Number. 
A null entry; causes 
lst Step to be assumed. 


A Step Number. 
A null entry; causes 
last Step to be assumed. 


A valid Step Number. 


A valid Step Number. 


Any response used for R. 


MEANING 


Invalid step number. 
The step does not contain the char- 


acters which were to be replaced. 


A global node was specified that 


does not have defined data. 


If editing had taken place, result 
would have exceeded the maximum 


string length. 
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ERROR MESSAGES MEANING 


THE GLOBAL (9g) This message will be output if an 
IS EQUAL TO (n) attempt is made to edit a global 
TO EDIT, USE containing numeric data. 
THE SET COMMAND 
where: 

g global name 


n numeric quantity to 
which global was set 


equal 


CHAPTER 5 
PROGRAMMING TECHNIQUES 


This chapter, provides the MUMPS programmer with supplemental informa- 
tion on several elements of the MUMPS Language. Sections 5.1 through 
5.5 discuss particular elements of the language, including the $J 

and SE System Variables, the VIEW command and SVIEW function, and 

a method for retrieving global data. Sections 5.6 and 5.7 discuss 
two considerations for program design: debugging and program size. 


The last sections are concerned with the use and design of globals. 
5.1 MASKING 


The programmer may extract individual bits of a word in storage by 
using the AND operator (&), which performs true Boolean AND. 
Table 5-1 lists the mask value for each bit. 


Table 5-1 
Bit Mask Values 


Mask 


20.48 41943.04 

40.96 83886.08 

81.92 167772.16 

163.84 335544.32 

327.68 671088.64 

655.36 1342177.28 
1310572 2684354.56 
2621.44 5368709.12 
5242.88 10737418.24 
10485.76 21474836.48 
20971.52 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
0 


_ 


If the bit to be examined is in a word stored as a MUMPS number, the 
programmer Simply ANDs the word with the appropriate mask value for 
that bit. For example, the following MUMPS command returns a True 
(-0.01) or False (0) result, depending on whether bit 4 of the $J 


System Variable contains a l or a 0 value. 
IF $J&.16 


If the bit to be examined is in a word not stored as a MUMPS number, 
the word must first be divided by 100, (e.g., values obtained from 

the SA System Variable or from use of the $VIEW function). For 
example, the following command return a True or False result, depending 


on whether bit 15 in SA contains al or 0 value. 


I $A/1008&327.68 


To prepare a location for bit manipulation, first divide by 100 (if 


the word is not stored as a MUMPS number) as follows: 
SV (SV (44) +46) /100 
To shift right (end off), divide by corresponding powers of 2:’ 


2% where x is bit positions to shift 


2+ =2 shift 1 bit 
2* =4 shift 2 bits 
28 -256 shift 8 bits (high byte to low byte) 


SV (SV (44) +46)/(100*256); shift high byte into low byte 


SV (SV (44) +46) *256; shift left 8 bits 


To mask, logically "AND" or "OR" using standard MUMPS masks. For 
example: 


SV ($V (44) +46) /100&10. 24; check if bit 10 set 


Add masks together to check multiple bits: 


SV (SV (44) +46) /100&(5.12+10.24); check if bits 9 & 10 set 


SV ($V (44) +46) /100&2.55; check for any bit set in low 
byte 


Combining operations: 


SV (SV (44) +46) /25600&2.55; shift high byte to low byte 
and check for any bit set in 
that byte 


‘To shift left (zero fill), multiply by corresponding powers of 2. 


a 


The following routine checks the status of any given bit in the SA 
System Variable by shifting the contents of the word to the right 
(dividing by 2) for successive bit positions. The selected bit 


position is determined by the value SET to N. 


Gtvens S N=15 

4.1 S A=$A/100 

4.2 F T=0:1:N S A=A/2 

4.3 I A&.O0l (go process error) 

4.4 (otherwise, continue I/O operattons) 


5.2 SJ SYSTEM VARIABLE 


The $J System Variable is available to the MUMPS programmer as a job 
status word for special applications checking. $J is stored as a 
MUMPS number and contains three bits which are of interest to the 


programmer. Table 5-2 describes these assignments. 


Table 5-2 
SJ Bit Assignments 


Meaning When Set to l 


Recognition of CTRL/C and BREAK for 
currently ASSIGNed terminals is enabled. 


A CTRL/C or BREAK has been received 
on the Principal I/O Device (cleared 
when the ASSIGN O:bve syntax is 
invoked.) 


Timed READ or LOCK overrun. 


5.2.1 CTRL/C and BREAK Recognition 


Bits 2 and 3 of the $J System Variable allow a programmer to control 
processing of CTRL/C and BREAK, to determine the status of a partic- 
ular job. For example, if the user logged-in simply to run a 
program, CTRL/C and BREAK are normally disabled. The program itself 
may check bit 2 to determine if this is the case, and enable them if 
it is necessary. In another situation, a program might disable 
CTRL/C and BREAK during a particular processing operation and use 
bit 3 to monitor attempts to use CTRL/C or BREAK. The program 


could notify the operator that special processing is taking place. 


5.2.2 Timed READ or LOCK Overrun 


The programmer may check the value of bit 4 in $J for a timed READ or 


a LOCK overrun. 


Bit 4 is set when the specified interval in the READ command expires 


and either 


@® no response was detected, or 


@ input was detected, but the user took more than the speci- 
fied interval to type another character or a line termina- 
tor. 


In either case, MUMPS returns a null string to the program. A timed 
READ in which the user successfully entered the data, or a non-timed 
READ, would clear bit 4. 


Example: 


Assume that device number 17 ts a data set terminal, and the 
user wtshes to dtseonttnue processing tf the terminal ts dis- 
connected on a request for tnput. 


A’ a? RR  DUARE YOU. READY?" te X2300 Or 57@ v.16 
(process data from remote terminal) 


fed 

4.2 
Bit 4 can also be set if the optional timeout argument is present on a 
LOCK command argument. If the specified number of seconds pass and the 
system has not "locked" the requested argument, then bit 4 is set and 
the program continues execution. If the system had succeeded in "lock- 
ing" the argument, or if there was no time switch on the LOCK, bit 4 


would be cleared. 
Example: 

A. lesDautA(1,2,3) :2euTeuSJ&.16nuT ! "NOT AVAILABLE" !uuGeu3 
5.3 WRITING ERROR PROCESSING ROUTINES 
The programmer may write his own error-processing routines using 
the SE System Variable. MUMPS normally considers all errors 
listed in Appendix C’ fatal. If one of these errors occurs, MUMPS 


enters an error index (in the range 0 to -.38) in the SE 


System Variable and reports the error on the Principal I/O Device. 


tExcept GARB errors. MUMPS reports MTERR or LPERR only if the user 
sets SE. eee 


If the programmer has set the SE System Variable to a Step or 


Part number and an error occurs, the system: 


e sets the $W System Variable to the value of SL when the 
error occurred 


e sets the SE System Variable to the error index for the 
error encountered (in the rage 0 to -.38) 


e transfers program control to the step or part number 
referenced by SE 


@® resets the user stack, causing currently active DO, CALL 
and FOR commands to be lost. 


The programmer examines SE to determine which error occurred and 
examines SW to determine where the error occurred. Note that the 
programmer must reset SE to a Step or Part number to control further 
error processing in his program; otherwise, error processing reverts 


to system control. 


If SE contains any negative MUMPS number or §, MUMPS performs its 
standard error processing when an error occurs (see 2.15). In this 
manner, the programmer may "turn off" applications error processing. 


EXAMPLE lL 


A programmer wtshes to output expltctt error messages for his 
applteatton programs. He creates an error message program named 
'ERR' with 88 parts, one part for each error generated by MUMPS., 
The error processing routine tn hts applteation program calls the 
part of 'ERR' whitch corresponds to the error index in SE. For 
example, part number 15 corresponds to the error tndex -.15, which 
tndtcates the tllegal use of a MUMPS command. 


"PRG! 

1.10 S SE=2 

1.20 : 

1.30 : 

1.40 . Suppose thts ltne contatns 
1.50 an tnvaltd command 

2.10 C ERR:-SE*100 

'"ERR': 


0.01 ; ERROR PROCESSOR 


15.10 A OT ! "SORRY, BUT LINE",SW," CONTAINS AN INVALID COMMAND!",!! 


EXAMPLE 2 


In thts ease, the programmer wishes to control error processing 
only when a DECtape error occurs. 


3.1 S $E=7 | 
3.2 A 56:3166 T "LABEL" S SE=0 
3.3 (continue I/O processing) 


X=SE,Y=SW G Y:X<>-.3 AO T ! "UNIT NOT READY!!",! 

"CHECK IF OFF-LINE OR NOT WRITE ENABLED.",! 

"TF NEITHER TYPE 'N' TO HALT PROGRAM; REPORT HARDWARE MALFUNCTION' 
"OTHERWISE, CORRECT AND TYPE 'Y' <CR>",!,2 I Z="Y" GY 


OB WN 
mWHHANn 


5.4 VIEW COMMAND AND SVIEW FUNCTION PROTECTION 
Several levels of protection are applied to the use of the VIEW 
command and SVIEW function. The highest level of protection is 
applied to the VIEW command when used to write into internal memory 
or onto disk. The lowest level is applied to SVIEW, which can only 
read memory locations. | 
The following protection applies to the VIEW command: 

@ Using VIEW to write to disk or memory: 

ae The user must be logged-in under the System UCI. 


OR 


The command must be executed from a Library 
Utility Program (see Chapter 4). 


b. For writing memory, the device number ASSIGNed must 
be either 63 or 46. For writing to the disk, 
device number 63 must be ASSIGNed. 


c. The "PRINTL4256" command must be issued prior to using VIEW. 


e Using S$VIEW to read from a disk or using $VIEW to read from memory: 


ae The user must be logged-in under the System UCI 


OR 


The command must be executed from a Library 
Utility Program (see Chapter 4). 


b. For reading memory, the device number ASSIGNed must 
be either 63 or 46. For writing to the disk, device 
number 63 must be ASSIGNed. 


NOTE 


The VIEW command ts not protected for 
addresses restding tn the ‘external memory 
page' of the PDP-11 (t.e., an address greater 
than or equal to 160000, or 56444, ,). 


The SVIEW Function can be used under the following conditions: 
e The user must be logged-in under the System UCI 
OR 


e The command must be executed from a Library Utility 
Program (see Chapter 4). 


5.5 USE OF THE IF COMMAND AND INDIRECTION SYNTAX TO RETRIEVE 
GLOBAL DATA 


This section outlines the elements of a program designed to retrieve 
global data. The programmer may wish to write a similar program 

if the application system occaSionally requires an unusual type of 
data search. A program of this type does not, however, retrieve 
data quickly. It may be useful in a particular application 
Situation only because the programmer does not have to spend time 


writing an efficient program to search for the needed data. 


The retrieval program first issues a "READWUX" command so that 

the user may enter the parameters on which to base the selection. 
The user's input entirely determines the record selection. A 

record usually has several data fields which may serve as the 
parameters. The uSer input is in the form of a parameter name, 
followed by a Boolean condition and the parameter value, followed by 
any other parameters. For example, a patient record may include 

the patient's age, sex, blood type and activity code. In an 


unusual Situation, the user may need to know the name of all 


female patients over 30 who have blood type AB and are going into 


surgery. The input line might be: 


parameters 


" gsuceesstve condtttons are 
enclosed tn parentheses 
parameter as nested Boolean funettons 

value 


Boolean Condition 


OR, since all subSequent parameters are "AND" conditions, 
the input line could be: 


AGE=>30,SEX="F"  TYPE="AB" ,ACT="8" 


where the commas are tmplted "ANDs" 
for the IF command (see below) 


The program then enters a loop which gets a record and sets up the 


local variables to compare with the user-selected parameters. For 


example: 
1g3: N=17538 
1.4 S N=N+1 I N=17968 Q ~this line gets records 
17,539 through 17,968 
1.5 S AGE=tAGE(1,N),SEX=*SEX(1,N),... -thts line sets up the 


local vartables. 


The program next compares the contents of the local variables with 

the parameters stored in the local variable 'X' by using the IF 

command and indirection syntax. When the indirection syntax is 

used to determine the argument of an IF command, the execution of 
commands on the remainder of the line is not dependent on the 

logical result of the IF. To test the result of the IF, the programmer 


must use the ELSE command. For example: 


1.6 I +X ELSE GOTO 1.4 tf the record does not mateh, 
go get another record 


If the selected record does fit the parameters, the lines following 
the IF command lines process the record, and then return control 


to the Step or Part which gets another record. 


5.6 DEBUGGING PROGRAMS 


Often the programmer may wish to interrupt the operation of his 
program at predetermined points to examine his program data in 
detail. After examination, he may wish to resume the normal sequence 
of operation from the point of interruption. This technique is 


especially useful in the early steps of program debugging. 


The BREAK command can be inserted anywhere in a stored program. 
Upon execution of the BREAK, the program is suspended and a '?' 

is printed, followed by the Step number where the BREAK was found, 
followed by the message 'BREAK'. The programmer has the option of 
examining and changing the contents of variables or of writing 

out all or part of the program. The program itself may not be 
changed until after a CTRL/C has been typed to remove the program 
from the BREAK state. If the programmer attempts to modify the 
program in the BREAK state a PROT error is generated. 


The GO command causes program execution to resume from the point 
where the BREAK occurred. 


If an error occurs while in the BREAK state or if CTRL/C is 
typed, continuation is not possible using the GO command, since 
system error processing removes the BREAK state from the user's 
partition. 


5.7 PROGRAM SIZE CONSIDERATIONS 


After System Generation, the amount of core space allocated to the 
user's partition is fixed and therefore is the critical factor 
which limits the size of a core resident program. Each MUMPS 
program must fit into the Program Buffer of the partition in which 


it is to run!?. 


The following paragraphs discuss the factors which affect the size 
of MUMPS programs and the technigues to use the available internal 
memory efficiently. 


‘During system generation, the System Manager/Operator may 
specify a standard partition size and one or more non-standard 
Sizes. The programmer may select the partition size in which 


a program is to run by using the optional syntax of the START 
command. 


As mentioned earlier, during execution MUMPS programs reside in the 
Program Buffer which is part of the user's partition. Since the 
size of each partition is fixed, so is the amount of space available 
for a program. This significant factor limits the Size of an 
executable program. Although the user does not have the ability to 
increase his partition size, there are a number of programming 
techniques to efficiently utilize available space. If a program has 
reached an irreducible size and is still too big, the user must 


consider segmentation, using the CALL and OVERLAY commands. 


5.7e1 Conserving Available Space 


The ultimate size of a program depends on: (1) the actual number of 
characters in the program, (2) the number of local variables, (3) the 
amount of data stored in these variables, (4) the manner in which 


these various elements are used with respect to one another. 


In order to create programs that make efficient use of space, the 
programmer should understand the basic structure of his partition 


and the dynamic nature of some of its component parts. Figure 


5-1 shows a simplified diagram of a MUMPS partition. 


LOW MEMORY |OVERHEAD AREA 


PROGRAM 


eine OF GROWTH 
FREE MEMORY 


HIGH MEMORY | SYMBOL TABLE tL oirecTION OF GROWTH 
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Figure 5-1 Basic Partition Layout 


There are three areas in the user's partition which compete for 
free memory: the Program Buffer, the User Stack, and the Symbol 
Table. The Program Buffer is the area which contains the actual 
MUMPS-1l program. The User Stack contains transient information 
used by the operating system in processing the user's program. The 
Symbol Table is the area where all locally defined symbols reside. 
All three of these areas in the partition are dynamic; they grow 


and shrink in response to program operation. Both the Program 


Buffer and the User Stack grow toward high memory, and the Symbol 
Table grows from the upper limit of the partition toward low memory. 
The area between the top of the Symbol Table and the bottom of the 
User Stack is free memory which can be utilized by any of these 
areas. Specific factors which directly affect the amount of storage 


required for each of these areas are discussed below. 


The size of the Program Buffer increases and decreases, within the 
limits of available free memory, in response to LOAD, CALL, and 
OVERLAY commands. Since all elements of a MUMPS program are brought 
into the Program Buffer, the size of a program can directly depend 


on the way it is constructed. 


a. To reduce the space required for a program: 


@e Abbreviate all commands and function calls 
to the legal limit. 


@e Omit leading and trailing zeroes from all 
numeric strings. 


e Keep program names, variable names, and 
comment lines as short as possible. 


e Put as many commands on a line as possible 
to reduce the total number of individual 
Step Numbers which must be stored. 


@e Do not duplicate arguments or literals 
unnecessarily. Whenever an argument string 
or literal is used more than twice ina 
program, store it in a local variable and 
make multiple references to it (use the 
Indirection Syntax Operator in the case of 
arguments). 


b. To conserve User Stack space: 
@e Avoid deep nesting of DO, CALL, and FOR 
commands by employing a different algorithm. 
e Use the XKILL command judiciously; use KILL 
instead, if possible. 


c. To save Symbol Table space: 


e If time is less important than available space, 
store variables in Global Files. 


e If a large number of local variables are re- 
quired, it may advantageous to concatenate 
them into one large string for storage as one 
variable and to extract each via the SExtract 
Function when needed. 


5.7.2 Segmenting Programs to Conserve Space 


The amount of space allocated to the partitions in which pro- 

grams run is fixed in size, and each program must fit into this 

Space. However, through the use of the CALL and OVERLAY commands, 

a program can cause the loading and execution of other programs 

in the UCI's Program Directory as well as Library Utility Programs 
filed in the System UCI's Program Directory. When a program is 

brought in by either CALL or OVERLAY, it replaces the invoking program 
and, unless otherwise specified, execution begins at the first non-zero 
part. A program accessed in such a way is treated like any other 
program; it may CALL or OVERLAY still more programs. This allows the 
effective size of a program to be extended indefinitely. However, 
because local variables remain intact on execution of a CALL or OVERLAY, 
a size problem may exist if the incoming program is larger than the one 
invoking it. While developing a program, the user may want to CALL 
another FILEd program (OVERLAY can only be used in Indirect Mode). The 
programmer must be sure that he has FILEd the program currently in his 


partition before using CALL; otherwise the original program is destroyed. 
5.8 GLOBAL ACCESS CONSIDERATIONS 


The scheduling algorithm used by the system's Executive (paragraph 
1.3.1.1) is designed to give jobs performing Global accesses (disk 
I/O) preference over other jobs in the system. When a disk input/ 
output task has completed, the requesting job is given an additional 
short time slice to process its next command. During this time 
slice the job retains control of the disk. This enables the job to 
perform another disk access, if desired, without having to wait 

for other jobs to complete their disk tasks. The programmer should 
exercise care when using this feature, since it is possible, through 
faulty programming techniques, to completely lock-out other MUMPS 
jobs from use of the disk. This prevents other programs from 
accessing Globals, and terminal users from filing and loading programs. 
In particular, a high frequency of disk I/O requests or interminable 
program loops containing disk I/O requests should be avoided. 


The programmer must assiduously avoid the creation of interminable 
loops which request disk input/output or lengthy disk I/O functions 
such as result from many global accesses. 


a. 1.2 G $L¢:$D(C4ACI)) H @ 


The above command line causes an interminable 
disk access loop if tA(I) is defined. The 
'HANGuw', intended to effect a job swap-out 
will not be executed. The correct procedure 
is shown below. 


b. 1.2 H OG $LESDCtACI)) 


This command line will cause the job to be 
swapped-out prior to each Global reference, 
thereby allowing other jobs to obtain use of 
the disk. 


5.9 GLOBAL DESIGN CONSIDERATIONS 


The following paragraphs describe some of the methods for creating 
and designing globals. The programmer should refer to the 
Introductton to MUMPS Language tutorial manual and Appendix G in 
this manual for detailed discussions on how MUMPS stores data 


in globals. 
5.9.1 String Data Storage 


As mentioned in paragraph 5.8, simultaneously running jobs compete 
with each other for disk access time. MUMPS makes at least one 
disk access each time a job references a global variable using 
full syntax. A particular job uSing a large number of global 
variables for its processing operations, therefore, takes a long 


time to run when there are many other jobs on the system. 


If a particular application program processes a large amount of 
string data, the programmer may reduce the number of necessary 
disk accesses by storing as much string data as possible ina 
global variable. The programmer may then store the contents of 
the global variable in a local variable to extract and process the 


relevant data. 


A global variable may contain many individual string data fields 
as long as the total length of all the fields does not exceed 


the maximum string length of 132 characters. 


The programmer should store the fixed length string data fields 
in the first part of a global variable. This allows him to use 
the SEXTRACT function to retrieve any particular field. The 
programmer may then store variable length fields, set off by 
delimiting characters, after the fixed length fields in the 
global. The programmer may use the SPIECE function to extract 
the individual variable length fields. 


As an example, suppose that a patient's hospital record contains 
a billing code, ward name, room number, doctor code, blood type, 
Rh factor, name, and activity. Each of these fields could be 
stored as separate global variables in the same global, or even 
as separate globals. The following command, however, stores all 
information in one global variable. 


btlltng code blood type deltmiters 
oy | cos 
S *#REC(1700,97)="04580BS13228AN/NARTEN , SUSAN/BILIRUBIN/" 
ward ) name activity 
room 
doetor 
code 
oe a 
fixed length vartable tength 
frelds fteltds 


If the user wished to find the names of all the patients in the 
obstetrics ward (OBS), he could use some form of the following 


command: 
TP. SE(X25.7 J="OBS" 7 OOP CK See) 


where "X" is a local variable containing one of the records in the 
global variable +REC. 


5.9.2 Downward Pointers 


The disk block address stored with a global variable that points 
to global variables on lower levels is called a downward pointer. 
MUMPS chooses downward pointers by uSing an algorithm that takes 
advantage of the rotational latency of the disk. In the time it 
takes to perform a disk READ operation, the disk turns to the 
block on the lower level. The position of the global variable 


containing the downward pointer is therefore critical. If the 
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global variable containing the downward pointer is moved onto 
a continuation block, the optimal rotational latency value is 
lost. This increases the amount of time it takes to search down 


the levels of a global. 


In order to maintain the proper rotational latency between the 
blocks, the user should ensure that the global variable containing 


the downward pointer is never moved onto a continuation block by: 


e storing data in the global variable, if any, before 
creating the first global variable at a lower level 


@ storing only fixed length data in the global variable 
containing a downward pointer 


NOTE 


Occasionally it is necessary to make major 
modifications of a global's structure or 
contents. The user can restore the optimal 
block allocation by saving the global data 
using the Global Save Utility Program, 

killing the global, and then restoring the 
global using the Global Restore Utility Program. 


5.9.3 Storing Large Amounts of Data 


The two primary considerations involved when storing large amounts 
of data are access speed requirements and storage limitations. 


The following paragraphs discuss the ways to balance these conditions. 


The fewer the number of physical disk block accesses required to 
retrieve data, the faster the retrieval time. The fastest way 

to retrieve data is by searching down -the levels of a global. If 
there are no continuation blocks on any one level of a global, 
MUMPS accesses only one block for each downward pointer. For 
example, a three-level global that uses no continuation blocks 
requires only three block accesses to retrieve any particular 


global variable, excluding the directory block access. 


Bach level of a global adds at least one block to the number of 
blocks required to store the data. If the amount of storage 
space is limited, the user may wish to store data on as few levels 


as possible, though he increases retrieval time. 


The following example illustrates the method for calculating the 
number of block accesses and the number of blocks required to store 
global data. Using this method, the programmer may deSign a 

global structure appropriate for his application situation. 
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Example: 


A user has 1000 records containing string data. Each record is 45 
bytes long. If one record is stored per global variable, there will 
be 1000 global variables containing data, and each variable will 
occupy 50 bytes of storage.! 


A disk block is 512 bytes lonc. MUMPS uses six of those bytes to 
store system information. There remain 506 bytes per block in 
which to store global variables. Since it is possible to store 10 
global variables in one block, it will take 100 blocks to store 
all the data (i.e., 506 bytes per block divided by 50 bytes per 
variable). 


The user may choose to store all the data on one level as a series 
of continuation blocks, requiring only the 100 disk blocks. The 
average number of blocks accessed to retrieve any particular global 
variable is 100 blocks divided by 2, or 50 blocks (excluding the 


directory block access). 


The user may also choose to create a 2-level global where the first 
level contains 2 pointers, each pointing to a group of 500 global 
variables. Each group of 500 nodes resides on 50 continuation 
blocks. For example, the first level might contain two pointer 
nodes tA(1) and tA(2). The second level would then contain 1000 
global nodes, tA(1,n) and tA(2,n) where n = 1-—- 500. The two 
pointer nodes would reside in one block; the total number of blocks 
required to store the global is 101. The average number of block 
accesses required to retrieve any particular global variable is 50 
blocks per pointer divided by 2, plus 1 block for the pointer, or an 
average of 26 accesses (excluding the directory block access). 


If the user creates a 3-level global, he might have 4 pointers 

on the first level, each pointing to a group of 25 pointers on 

the second level, each of which, in turn, points to a single block 
containing 10 global variables storing data on the third level. 
This global requires 100 blocks to store the data, plus 

5 block to store the pointers -=- one block for the first level 


1The programmer should refer to Appendix G in this manual to determine 
the number of bytes required to store any particular data type. 
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pointers, and 4 blocks for the second level pointer--or a total 

of 105 blocks for the entire global. The maximum number of blocks 
accessed to retrieve any global variable is only three (once again 
excluding the directory level access). It is evident that increasing 
the number of blocks required to store a global can significantly 


decrease the retrieval time. 


The user may also try another possible arrangement. In the 2-level 
structure described above, the "data" nodes reside in two groups 

of 50 continuation blocks each. The large number of continuation 
blocks account for the major portion of the retrieval time. If 

the user decreases the number of continuation blocks, he can 


decrease the average retrieval time. 


A global variable which contains a downward pointer and no other 
data requires only 6 bytes of storage space. It is therefore 
possible to put as many as 84 "pointer" nodes in one disk block. 
If the user creates a 2-level global with 100 pointers on the first 
level which each peint to a block on the second level containing 
the 10 global variables, he needs only 2 blocks to store the 

100 pointers. The entire global requires only 102 blocks of 
storage space. The number of blocks accessed to retrieve any 
global variable on the second level is either 2 or 3, depending 
on whether MUMPS has to read the continuation block on the second 
level to find the proper pointer. Most of the time only 2 blocks 
will be accessed because most of the pointers are in the first 
block. This compromise is the most effective solution for this 


particular data base. 


5.10 USING SWITCH REGISTER SWITCHES FOR PROGRAM CONTROL 


In addition to being used to initialize and control the operation of 
the MUMPS system software’, the PDP-11 console SWITCH REGISTER 
Switches can also be used to effect control of any MUMPS program. 
Many of the system utility programs described in the MUMPS Operator's 


Guide use this feature. 


The console SWITCH REGISTER consists of sixteen switches (@ thru 15). 
Several of the switches perform specified predefined functions in 
the operating system (Table 5-3). In general, these switches, 

except for switch number 6, should not be used Since their primary 
function could conflict with the user's intended application. The 
programmer should instead use switch number 6 to effect a shut- 

down of the application system software. The switches that have 

no specific MUMPS system assignment can be used, but are subject 

to future assignment by DIGITAL. The use of a switch to cause program 
shutdown is particularly important for STARTed programs that are not 
controlled through a device keyboard or other logical input. Unless 
switch control is used, programs of this sort can only be stopped by 
actually HALTing the MUMPS operating system. 


Since the SWITCH REGISTER switches are a form of input device, they 
communicate with the processor through a status word in the PDP-ll's 
"external page' at address 777578 (octal) or 65498 (decimal). Each 
bit in the status word corresponds to one of the switches. For 
example: bit @ corresponds to switch @, bit 1 corresponds to switch 


1, etc. When a switch is ON (raised) its status word bit is set to one. 


Using the $V function, MUMPS programmers can obtain the current 

status of the switches. The appropriate bit or bits can be examined 
in a Boolean expression that uses the bit masking techniques described 
in 5.1. The last column in Table 5 shows the masks for each bit. 


The following examples below show how the switch status can be obtained. 


‘Described in Chapter 4 of the MUMPS-11 Operator's Guide. 


Table 5-3 


MUMPS SWITCH REGISTER Assignments and Bit Masks 


Switch Number Bit Mask MUMPS System Function 


01 Console Terminal Control 
~ 62 
64 Unused 
. £8 
- 16 Garbage Collector Control 
232 Unused 
64 System Shutdown Control 
1.28 
2%26 
5.12 
18.24 
28.48 
48.96 | Partition Grant Control 
81.92 System Processing Control 
163.84 Unused 
327.68 Interpreter Control 
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Examples: 


1. To see if switch number 6 is ON: 
6.23 I * ($V(65400)/108&.64=.64) T "RAISE SWITCH NO. 6”,! G $L 
Ze. FO HALT 22 both switch number 6 and switch number 1 are ON: 


3.45 I $V(65400)/108&.662.66 H 


Array 


Binary Operator 


Boolean Valued Expression 


Command 


Concatenation 


Constant 


Data Base 


Direct Mode 


Directory 


Double Numeric Quantity 


Expression 


APPENDIX A 
GLOSSARY OF TERMS 


An array, which can consist of either local or global variables, is a group of 
subscripted variables that have a common identifier. 


A binary operator is an operator that requires two operands (expression 
elements). 


A Boolean Valued Expression (bve) is an expression, which, when evaluated, 
produces either a True (0.01) or False (0) result. 


A command is the principal algorithmic component of the MUMPS Language. 
MUMPS commands consist of a set of keywords that characterize actions. 
(e.g., GOTO, SET, HALT, RUN, etc.) 


Concatenation is the process of linking together two or more string data 
elements to form a single string. Concatenation is a string expression 
operation that is designated by the commercial “‘at” sign (@). 


A constant is a quantity within the range of legal MUMPS numbers 
(+21474836.47) explicitly stated in an argument to a command or as an 
operand in an expression. 


Data base is that body of disk-stored information residing in global arrays. 


Direct Mode is that mode of system operation which enables the programmer 
to: 


a. enter commands and/or functions for immediate execution 
b. create or modify steps of a user’s program 


A directory is a disk resident table which can contain the names and disk 
starting addresses of either programs or global files. Each User Class Identifier 
in a MUMPS-+11 system is associated with two directories; a program 
directory, and a global directory. 3 


This term refers to MUMPS numbers whose absolute values lie in the range 
4327.68 through 21474836.47 which are stored by the operating system in 
two consecutive words. (See also Single Numeric Quantity.) 


An expression is any legal combination of operands (elements) and operators. 
Legal expression elements include: literals, constants, variables, 
subexpressions, and function references. An expression may consist of a 
single element, an element/operator combination or a series of 
element/operator combinations. 
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Expression Element 


Floating Point Numeric 


Function 


Global 


Global Variable 


Identifier 


IF Switch 


Indirect Mode 


Indirect Reference 


Job 


Library Program 


An expression element is the operand component of a MUMPS expression. 
An expression element may be a constant, a simple variable, a literal, a local 
subscripted variable, a global variable, a function reference, or a 
subexpression. 


A 4-word floating point number in the range +0.14*10°® to +1.7*10°%. The 
MUMPS $M function allows floating point numbers to be used with the 
operators + - * /<)=. A Floating Point number may be stored only as a local 
variable which is not the name of an associated array (i.e., pointer variables 
are excluded) or as a global variable. 


A function is a MUMPS expression component that invokes an algorithm, the 
result of which is an expression element (operand). Each MUMPS function is 
assigned a unique mnemonic, the first character of which is the dollar sign ($) 
symbol. 


A global is a tree-structured data file stored in the common data base on the 
disk. Globals comprise an external system of symbolically referenced arrays. 


A global variable is a subscripted variable that forms an element (or node) of 
a global array. 


An identifier is a name consisting of one to three alphanumeric characters. 
The first character must be either an alphabetic character or the percent (%) 
symbol. Identifiers are used as names for variables, programs, library (or 
system) programs, and globals. The percent symbol is reserved for naming 
Library Programs and Globals, though any local variable can use percent as 
the first character of its name. 


The IF Switch is a logical switch that resides in the Program Vector area in 
each user’s partition. This switch is set to the logical result of the last 
executed IF statement, either True (-0.01) or False (0). Note that an IF 
without arguments or an ELSE only tests the logical value of the IF Switch 
and does not change it. 


Indirect Mode is that mode of system operation in which the steps of a stored 
program are executed. In this mode of operation, commands cannot be 
entered from the terminal and programs cannot be created or modified. 


An indirect reference is a feature of the language that permits a string variable 
to represent a command’s argument or argument list. In operation, the string 
value of the variable is taken as the argument or argument list. The 
indirection symbol, back arrow (<) or underscore (___), must precede the 
variable reference. 


A job is any user activity which requires the use of a partition. For example, 
logging in or STARTing a program are Jobs. 


This term refers to those programs that are listed in the Program Directory of 
the System UCI (UCI #1) and have a percent symbol (%) as the first character 
of their names. Programs residing in the system in this way can be run by any 
user regardless of UCI. 
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Literal 


Local Variable 


Naked Reference 


Node 


Numbers 


Numeric Valued Expression 


Operator 


Part Number 


Partition 


Pattern Verification 


Principal I/O Device 


A literal is an element of the language that permits the explicit representation 
of character strings in expressions and in command and function arguments 
by delimiting them with quotation marks (“‘”’). Literals may not contain: 


quotation marks CTRL O Line Feed 
Carriage RETURN CTRL C Form Feed 
ALT MODE CTRL U Vertical Tab 
RUBOUT (DEL) NUL 


A local variable .is a variable that resides in the partition of the program that 
created it (as opposed to a global variable). 


The naked reference is a feature that provides an abbreviated method for 
accessing global variables to reduce disk access time. This permits subsequent 
references to a global to be made simply by specifying an up-arrow (f) 
followed by one or more subscripts. The variable name is assumed from the 
last global reference in which a name was explicitly stated. The first subscript 
in the naked reference replaces last subscript in the previous reference (either 
naked or complete). Using the naked reference reduces disk access time since 
the search for the specified node begins at the subscripting level attained by 
the last global reference rather than at the global directory level. 


A node is a global array element addressed by a subscript. 


Numbers in MUMPS are signed fixed-point quantities in the range 
+21474836.47. Decimal fractions greater than two places are truncated to 
two places. 


A numeric valued expression (nve) is an expression which, when evaluated, 
produces a numeric result. 


An operator is a component of a MUMPS expression that invokes an 
algorithm to perform either arithmetic, string, or Boolean manipulations. (See 
binary operator and unary operator.) 


A part number is the integer portion of a step number and is used to refer 
collectively to all steps having a common integer base. 


A partition is the memory area within which a job resides. A partition is 
allocated to a job either at terminal log-in time or upon execution of the 
START command. A partition contains both program and local variable 
storage areas as well as program state information necessary for timesharing 
operation. 


Pattern verification is a feature of the language which permits evaluation of 
text strings for the occurrence of desired combinations of alphabetic, numeric 
and punctuation characters. Pattern verification is specified by the “?” 
operator followed by Pattern Specification Codes (psc). 


This term refers to the keyboard terminal that initiated the job. This is the 


device to which control returns when an error message is to be output or 
when an ASSIGN __,0 command is issued. 
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Program Name 


Programmer Access Code 


Queue 


Run Queue 


Secondary Storage 


Single Numeric Quantity 


Sparse Array 


Step Number 


String 


String Concatenation 


String Valued Expression 


Subexpression 


Subscripts 


Subscripted Variable 


System Program 


A program name is an identifier that is associated with a particular program. 
System Library program names must use the percent symbol (%) as the first 
character. 


The Programmer Access Code (PAC) is a three-character code, created at 
System Generation time, that allows the terminal user to enter Direct Mode. 


A queue is an ordered list in which the first item to be entered is the first 
item to be removed (first-in-first-out sequence). 


The Run Queue is a System Queue which contains the number of the job 
currently executing in its time slice. This queue is effectively a one entry 
queue. 


This term refers to all I/O devices which are not used to contain the global 
data base (non-disk), (i.e., paper tape, magtape, or DECtape). 


This term refers to MUMPS numbers in the range 327.67 which are stored 
by the operating system in one 16-bit word. (See also Double Numeric 


Quantity.) 


A sparse array refers to the method of storage allocation used for local and 
global arrays in which space is allocated only as variables are explicitly 
defined (unlike other languages which require dimension or size statements 
for preallocation of storage). 


A step number is a number used to identify each line of a MUMPS program. 
A step number must be in the range 0.01 — 327.67, excluding all numbers in 
this range that are integers. 


A string is a contiguous combination of any of the ASCII characters. 
(132 characters maximum) 


See Concatenation. 


A string valued expression (sve) is an expression which produces a string 
result upon evaluation. 


A subexpression is an expression element that consists of any legitimate 
expression enclosed in parentheses. 


A subscript is a numeric valued expression or expression element which is 
appended to a local or global variable name to uniquely identify specific 
elements of an array. Subscripts are enclosed in parentheses. Multiple 
subscripts must be separated by commas. 


A subscripted variable is a variable to which a subscript is affixed (see 
subscript and variable). Both global and local variables are forms of 
subscripted variables. 


A System Program is a program either supplied by DEC or created by the 
MUMPS user which is used to assist the MUMPS system owner in the 
operational maintenance of the system. System Programs normally reside 
under the protection of the System UCI (UCI #1). 
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System Queues 


System UCI 


System Variable 


Time Slice 


Unary Operator 


User Class Identifier (UCI) 


Variable 


Wait Queues 


This term refers to the set of queues used by the MUMPS Operating System 
to control the allocation of system resources (see Run Queue and Wait 


Queue). 


The System User Class Identifier (UCI) code is that UCI code assigned to the 
first entry in the system’s UCI table. The Program and Global Directories 
associated with the System UCI are used to contain both System and Library 
programs and globals. 


A System Variable is a variable that is permanently defined within the 
operating system. These variables provide system and control information to 
all programs. The first character of a System Variable is always a dollar sign 
($). System Variables are maintained and modified by the operating system 
and/or system manager only. 


This term refers to the period of time allocated by the operating system to 
process a particular partition’s program. This term is synonymous with 
‘timesharing interval’. 


A unary operator is an operator that requires a single operand (expression 
element). 


A UCI is a three-character code used at terminal log-in time to permit access 
to the group of programs and global files with which it is associated. When 
used with the Programmer Access Code, the UCI allows these programs to be 
modified and new programs to be created. 


A variable is the symbolic representation of a logical storage location. Specific 
types include local, global, simple and subscripted variables. Variables are 


symbolically referenced by means of identifiers. 


The Wait Queues are a group of System Queues which contain the numbers of 
the jobs awaiting service by the operating system. 


APPENDIX B 
MUMPS CHARACTER SET 


The following table shows, with the corresponding octal] and decimal equivalents, the 128-character set of 7-bit 
ASCII code used by MUMPS for data, command, and control purposes. In addition, the order of the character set as 
shown establishes the MUMPS collating sequence used by the system’s Expression Evaluator when establishing string 
relationships. 


For command and control purposes, MUMPS uses the 64-character graphic subset. The system also uses the control 
codes shown in brackets ([ ]). These codes may not be used as input data. The NUL, code 000, is used internally as 
a logical end-of-message and cannot be used. Characters shown in braces ({ }) are part of the 1963 ASCII Character 
Set and may appear in the character set of some terminals. 


All characters may be used for data input and output except for these mentioned above. The system does not 
perform any character conversion. It is the programmer’s responsibility to perform all upper/lower-case letter 
conversions or mappings which are required for the particular application. 


CHARACTER SET 
Octal Code Decimal Code Character Octal Code Decimal Code Character 

000 000 NUL {025 021 NAK (CTRL U)*] 
001 001 SOH (Backspace)+ 026 022 SYN 
002 002 STX (Forward space)t} 027 023 ETB 
003 003 ETX (CTRL C)*(Write tape mark)}+ | 030 024 CAN 
004 004 EOT (Write block)+ 031 025 EM 
005 005 ENQ (Rewind) 032 026 SUB 
006 006 ACK (Read block)t [033 027 ESC (ALT MODE)* ] 
007 007 BELL (Read label)t | 034 028 FS 
010 008 BS* (Write header label)t 035 029 GS 
O11 009 HT (Write EOF label)t 036 030 RS 
012 010 LF 037 031 US 
013 011 VT 040 032 Space 
014 012 FF 041 033 
015 013 CR 042 034 “ 
016 014 SO 043 035 # 

[ 017 015 SI(CTRL 0)* | 044 036 $ 
020 016 DLE 045 037 %o 
021 017 DCI 046 038 & 
022 018 DC2 047 039 : 
023 019 DC3 050 040 ( 
024 020 DC4 051 041 ) 


* Asterisk denotes the control function for MUMPS terminals, if different from specified or other use. 
{Dagger denotes the control function for magtape devices. 
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CHARACTER SET (Cont) 


Octal Code Decimal Code Character Octal Code Decimal Code Character 
052 042 * 125 085 U 
053 043 + 126 086 V 
054 044 127 087 W 
055 045 = 130 088 x 
056 046 131 089 Y 
057 047 / 132 090 Z 
060 048 0 133 091 [ 

061 049 1 134 092 \ 

062 050 2 135 093 ] 

063 051 3 136 094 A 4<t 
064 052 4 137 095 — {< 
065 053 5 140 096 \ 

066 054 6 141 097 a 

067 055 7 142 098 b 

070 056 8 143 | 099 C 

071 057 9 144 100 d 

072 058 ; 145 101 e 

073 059 146 102 f 

074 060 < 147 103 g 

075 061 = 150 104 h 
076. 062 > 151 105 i 

077 063 7 152. 106 j 

100 . 064 @ 153 107 k 

101 065 A 154 108 l 

102 066 B 155 109 m 
103 067 Cc 156 | 110 n 

104 068 D 157 111 0 

105 069 E 160 112 p 

106 070 F 161 113 q 

107 071 G 162 114 r 

110 072 H 163 115 : 

111 073 I 164 116 t 

112 074 J 165 117 u 

113 075 K 166 118 v 

114 076 L 167 119 Ww 

115 077 M 170 120 x 

116 078 N 171 121 y 

117 079 O 172 122 z 

120 080 P 173 123 { 

121 081 Q 174 124 ! 

122 082 R 175 125 } tate MODE)* 
123 083 S 176 126 ~ J (ALT MODE)* 
124 084 T 177 127 DEL (RUBOUT)} 


*Asterisk denotes the control function for MUMPS terminals, if different from specified or other use. 
+Dagger denotes the control function for magtape devices. 
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APPENDIX C 
EXPLANATION OF MUMPS MESSAGES 


When execution of a MUMPS program is terminated by either an error, a CTRL C, or by pressing the BREAK key, 
the program executive outputs a short message to indicate the reason for termination. This message is followed by 
the number of the Step being executed and the program name unless the error occurred while in Direct Mode. The 
error message format is: 


? message > spn _,pnam 
MUMPS messages are categorized as follows: 


1. | MUMPS Programming Error Messages — result from errors associated with programming problems (either 
incorrect language syntax or semantic misunderstandings). 


Zi Voluntary Program Termination Message — there is only one message of this type. 
3. Debugging Aid Message — indicates that a BREAK command has been encountered in the program. 


4. Operating System Error Messages — result from various troubles which are detected by the operating 
system and which are beyond the control of the MUMPS application programmer. 


MUMPS errors are considered terminal unless the user’s program Sets the $E System Variable for application 
program control of error processing. The programmer may Set $E to a Step or Part number (S,_,$E=spn) to which 
control will go if an error occurs (except GARBO — GARB4 errors which are reported only on the console terminal, 
and do not terminate a running job). When $E is set to an spn and an error occurs, the system transfers control to 
the spn and resets $E to an index in the range 0 through -0.38 which indicates the type of error encountered (e.g., 0 
= INRPT, -0.01 = MXNUM -— see below). The number of the Step that contains the error is entered in the $W 
System Variable. The system also cancels all currently active DO, FOR, and CALL commands. It is the user’s 
responsibility to reset $E to an spn if he wishes to control further error processing; otherwise, error processing 
reverts to system control. 


If an error occurs and $E is not set by the programmer, the action taken by the system depends on the mode in 
which the user signed on at log-in. If the programming access code (PAC) was used, control is returned to Direct 
Mode after the error message is output. Otherwise, the job is aborted after typing the error and ‘EXIT’ messages and 


the terminal is automatically logged-out. 


Each of the messages is explained on the pages which follow: 
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C.1 MUMPS PROGRAMMING ERROR MESSAGES 


Message 


CMMND 


DIVER 


DKSER 


FRACT 
FUNCT 


LBOV 


SMERR 


MINIM 


MINUS 


MODER 


MXNUM 


MXSTR 


$E Index 


-0.15 


-0.19 


-0.04 


-0.08 


~0.07 


-0.14 


-0.36 


-0.03 


-0.12 


-0.23 


-0.01 


-0.02 


Meaning 
Indicates illegal use of a command: 


a. Command is undefined in the language; 
b. | An argument has been omitted where required. 


Indicates an attempt to perform division by zero. 


If not a system software error (C.4), this user software error indicates an 
attempt to: 


a. use VIEW command to access a block number larger than size of 
the referenced disk, or a nonexistent disk; or 

b. use the disk (e.g., creating global variables, issuing the FILE, 
LOAD, etc., commands) under a UCI that has no associated 
directories. 


Indicates that a fractional number was encountered when the process being 
executed was expecting a integer number. Also involved when a Step number 
has no fractional part. 


Indicates that the function is undefined in the language. 

Indicates an attempt to input or output a line greater than 132 characters. 
Indicates that an error occurred in $M processing. 

exponent overflow 

exponent underflow 


division by 0 
illegal trap instruction (system error) 


aoc. 


Indicates that a number has more than two digits following the decimal point. 


Indicates that a negative or zero number was encountered when a positive 
number was expected. For example, MUMPS causes a MINUS error if the user 
references a subscripted variable with a negative subscript. Only positive 
subscripts are allowed, except when using the $HIGH function © 


a. An nve was encountered where an svi was expected or vice versa. 
b. Argument to $TEXT is not numeric. 
c. Argument to $VIEW is not numeric. 


Indicates that the value of a number has exceeded the integer bounds set by 
the MUMPS system. The maximum value for a number is +21474836.47. 


Indicates that the string has exceeded maximum length allowed (132 
characters). 
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Message 


NAKED 


NODEV 


NOPGM 


NOTSY 


NXMEM 


PGMOV 


PROT 


SBSCR 


SPNER 


STKOV 


STKUN 


SYMOV 


$E Index 


-0.29 


-0.13 


-0.28 


-0.34 


-0.05 


-0.24 


-0.06 


-0.09 


-0.17 


-0.10 


-0.11 


-0.16 


Meaning 


Indicates that the present user attempted to reference a global variable using 
“naked” syntax: 


a. prior to any full syntax reference; or 
b. after another user KILLed the global variable. 


Indicates an attempt to ASSIGN a nonexistent device or the use of an illegal 
device number. 


Reference is made to a program name that does not exist in the program 
directory for this UCI and is not in the directory of Library (%) Programs. 


Indicates that the referenced device or function is not in the system (it may 
not have been linked at system generation). 


Non-Existent Memory was referenced in VIEW command or $VIEW function. 


Indicates that there is insufficient space available in the partition. Caused by: 


a. ‘too many program steps in the program being created via the 
terminal or in the program being loaded; (LOAD, CALL and 
OVERLAY commands) 


b. — too many local variables; 
c. expression or subscript nesting too deep. 


Indicates that an attempt was made to use either the VIEW Command or the 
$VIEW Function from a non-Library (%) Program or when not logged in 
under the System UCI. Also indicates that the MODIFY command issued 
from Indirect Mode specified an spn smaller than the current spn. 


Indicates illegal subscript usage: 


— subscript out of range; 
— negative subscript. 


Indicates that an illegal or nonexistent Step or Part number was used. 
Indicates that the available stack space is used up. Generally indicates nesting 
is too deep in DO or CALL statements , 

Indicates execution of the Overlay command from Direct Mode (stack 


underflow). 


Symbol Table Overflow occurred on an attempt to create or change a local 
variable. 
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Message $E Index Meaning 


SYNTX -0.27 Indicates that the current Step being executed has an error in syntax. Syntax 
| errors include illegal punctuation, illegal use of operators, illegal use of 
parentheses, as well as errors encountered in editing a Step. Syntax errors 
comprise a great majority of errors made in the MUMPS system and usually 
the user will be able to determine the exact cause of the error by merely 

looking at the Step concerned. 


UNDEF -0.21 Indicates a reference to an undefined local or global variable. 


C.2 VOLUNTARY PROGRAM TERMINATION 
Message $E Index Meaning 


INRPT 0 Signifies interruption of program execution caused by typing CTRL C or 
pressing the BREAK key. 


C.3.> DEBUGGING AID MESSAGE 
Message SE Index Meaning 


?n BREAK None Indicates that program control has reached a BREAK command at Step n. 
BREAK commands are used to interrupt execution of the program for 
debugging purposes. The GO command may be typed to resume operation. 


C.4 MUMPS OPERATING SYSTEM ERROR MESSAGES 


Message $E Index Meaning 

GARBO None _ Disk error while reading a data block. 

GARBI None Disk error while writing a data block. 

GARB2 None Disk error while reading a bit map. 

GARB3 None Disk error while writing a bit map. 

GARB4 None Disk error, an attempt to deallocate a bit map or data block not yet allocated. 
NOTE 


The above errors are disk errors detected by the system’s 
Garbage Collector routine. The message is output to the. 
console terminal. GARB1 and GARB3 result in suspension of 
all disk I/O until system restart. Notify system manager. 


DBDGD -0.31 Indicates a data base degradation. The system attempted to read a block that 
was not actually allocated. Notify system manager. 


DKDER -0.33 Indicates that a disk I/O error occurred on an attempt to write a global data 
buffer. The error is not given until the write is actually attempted. 


Message 


DKFUL 


DKHER 


DKSER 


DSKDG 


DTERR 


LPERR 


MTERR 


PLDER 


SWAP 


SYSDG 


SYSER 


SE Index 


-0.26 


-0.20 


-0.04 


-0.18 


-0.30 


-0.38 


-0.37 


-0.35 


-0.32 


-0.25 


=0:22 


Meaning 


Indicates that there is no more room on the disk for global or program 
storage. Caused by SET and FILE commands. Notify system manager. 


Indicates disk hardware error. Notify system manager. 


In addition to conditions listed under C.1, this may indicate that disk block 
pointers in the global data base reference nonexistent or invalid disk blocks. 
Notify system manager. 


Indicates disk degradation. Attempt was made to allocate bit map for data 
storage. The system corrects the bit map subsequent to this error. Notify 
system manager. 


Indicates DECtape hardware or operator error. Common causes are: 
a. not set to ON LINE; 
b. not set to WRITE ENABLE; 


C: unit number not selected. 


Indicates a line printer hardware error. Common causes are: 


a. device off line 
b. out of paper 
c. yoke open 

d. power off. 


Indicates magtape hardware or operator error as determined by the current 
contents of the $A System Variable. The system generates this error only if 
the user SET the $E System Variable. | 


The system cannot retrieve the program being LOADed, CALLed, or 
STARTed. The FILE command did not complete writing the program. The 
user must re-FILE the back-up copy of the program. 


Indicates 
a. that the previous swap-out overflowed the user partition stack. The 
error is not reported until the next swap-in. 


b. imminent system stack overflow, May be caused by faulty programming 
techniques, for example: 
1.10 F J=1:1:1000 D 2 
2.10D 1 


Indicates that the table in main memory which represents the bit maps on a 
physical disk unit (Disk Storage Allocation Table) does not correspond to the 
block allocation specified by the disk’s bit maps. The Disk Block Tally Utility 
Program allows recovery from this error. Notify system manager. 


System stack underflow on swapout. Notify system manager. 
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SYMBOL USAGE 


The following special symbols are used by MUMPS in addition to the logical operators described in Chapter 2. 


Symbol Definition 


# Number sign is used as a format control character to initiate a Page Feed or a FORM FEED on an 
output device. 


! Exclamation point is used as a format control character to initiate a Carriage RETURN/LINE 
FEED sequence on an output device. 


? Question mark is multiply defined: 


a. aS an output format control character for terminals, line printer and paper-tape punch, 
it is followed by an nve to indicate the number of spaces to tabulate in from the 
absolute left margin (e.g., ?5=5 spaces from the left margin); 


b. as an expression operator, it is followed by a Pattern Specification Code (psc). 


c. it is the first character printed when a BREAK command or error interrupts a 
program’s execution. 


: Comma is used as the term separator in an argument list. 
L43 Space is multiply defined: 
a. A command followed immediately by two spaces indicates the command has no 
arguments; 


b. One space separates a command from its arguments, or the last argument of a 
preceding command from the next command on the line. 
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Symbol 


Definition 


Colon is multiply defined: 


a delimiter for field separation in the argument of FOR, MODIFY, and ASSIGN 
commands. 


used to indicate the presence of an optional expression appended to a command or the 
argument of a command (where allowed). 


used to indicate the presence of an optional bve appended to a command (:bve may 
not be appended to FOR, ELSE or IF commands). If the bve is true, the command is 
executed. If the bve is false, control is passed to the next command on the line or the 
next line (whichever is applicable). The “next command on the line” is identified by 
skipping to the second space following the bve. If a bve is appended to a command no 
argument of that command may contain a space (i.e., a string literal enclosed in 
quotes). 


Semicolon is used as a delimiter to indicate that the remainder of a line is a comment. 


Right caret is the prompting character used by MUMPS-11 when operating in Direct Mode to 
signal to the user that the system is ready to accept a command; that is, commands and functions 
may be entered for immediate execution, or program steps may be entered for program execution. 


Dollar sign is multiply utilized. 


a. 
b. 


precedes the first character of a System Variable. 
precedes the first character of a function name. 


Percent sign is used as the first character of a library program or library global name. 


Quotation marks are used to delimit literals. 


Back arrow or underscore is used to specify the indirection operation used for command argument 
replacement. | 


Up-arrow or up caret precedes a global variable reference. 


APPENDIX E 
CONVERSION TABLES 


2” IN DECIMAL 


Xx zZ" x 2" Xx ey 
0.00] 1.00069 33874 62581 0.01 1.00695 55500 56719 0.1 1.07177 34625 36293 
0.002 1.00138 72557 11335 0.02 1.01395 94797 90029 0.2 1.14869 83549 97035 
0.003 1.00208 16050 79633 0.03 1.02101 21257 07193 0.3 1.23114 44133 44916 
0.004 1.00277 64359 01078 0.04 1.02811 38266 56067 0.4 1.31950 79107 72894 
0.005 1.00347 17485 09503 0.05 1.03526 49238 41377 0.5 1.41421 35623 73095 
0.006 1.00416 75432 38973 0.06 1.04246 57608 41121 0.6 1.51571 65665 10398 
0.007 1.00486 38204 23785 0.07 1.04971 66836 23067 0.7 1.62450 47927 12471 
0.008 1.00556 05803 98468 0.08 1.05701 80405 61380 0.8 1.74110 11265 92248 
0.009 1.00625 78234 97782 0.09 1.06437 01824 53360 0.9 1.86606 59830 73615 
+n 
10 IN OCTAL 
10° n 10” 10° n 10” 
1 0 1.000 000 000 000 000 000 OO 112 402 762 000 10 0.000 000 000 006 676 337 66 
12 1 0.063 146 314 631 463 146 31 1 351 035 564 000 11 0.000 000 000 000 537 657 77 
144 2 0.005 075 341 217 270 243 66 16 432 451 210 000 12 0.000 000 000 000 043 136 32 
1750 3 0.000 406 111 564 570 651 77 221 411 634 520 000 13 0.000 000 000 000 003 411 35 
23 420 4 0.000 032 155 613 530 704 15 2 657 142 036 440 000 14 0.000 000 000 000 000 264 11 
303 240 5 0.000 002 476 132 610 706 64 34 327 724 461 500 000 15 0.000 000 000 000 000 022 01 
641 100 6 0.000 000 206 157 364 055 37 434 157 115 760 200 000 16 0.000 000 000 000 000 001 63 
113 200 7 0.000 000 015 327 745 152 75 5 432 127 413 542 400 000 17 0.000 000 000 000 000 000 14 
360 400 8 0.000 000 001 257 143 561 06 67 405 553 164 731 000 000 18 0.000 000 000 000 000 000 O01 
545 000 9 0.000 000 000 104 560 276 41 
n log,, 2, n log, 10 IN DECIMAL 
n n log;o 2 n log, 10 n nN logio 2 n logs 10 
1 0.30102 99957 3.32192 80949 6 1.80617 99740 19.93156 85693 
2 0.60205 99913 6.64385 61898 7 -2.10720 99696 23.25349 66642 
3 0.90308 99870 9.96578 42847 8 2.40823 99653 26.57542 47591 
4 1.20411 99827 13.28771 23795 9 2.70926 99610 29.89735 28540 
5 1.50514 99783 16.60964 04744 10 3.01029 99566 33.21928 09489 
Addition Multiplication 
Binary Scale 
Oho =. Oo O00. 26 
O21 a0: =.4 Ox 1S 1 oO =0 
Tt S710 je ae mea 
Octal Scale 
O101 02 03 04 O5 O06 O7 
= = 3.11037 552421, e = 2.55760 521305s —— 0.44742 147707, 
a7! = 0.24276 301556, e-' = 0.27426 530661. Iny = — 0.43127 233602, 
\e > 1.61337 611067, Vex 1.51411 230704, logzy = — 0.62573 030645, 
Inz = 1.11206 404435, logioe = 0.33626 754251. V2= 1.32404 746320, 
logz2 77 = 1.51544 163223, logze = 1.34252 166245. In2 = 0.54271 027760; 
V10 = 3.12305 407267, logz2 10 = 3.24464 7411362 In 10 = 2.23273 067355, 


E-1 


OWMONA NXAWNHKHKO FB 


POWERS. 


000 
000 
000 
000 
000 
000 
000 
000 
000 
000 


OF 


TWO 


5 
25 
625 
312 
156 
578 
289 
644 
822 
411 
205 
102 
051 
025 
512 


5 

25 

125 

062 5 

531 25 

265 625 

132 812 5 

566 406 25 

783 203 125 
391 601 562 5 
695 800 781 25 
847 900 390 62! 


0777 
(Octal) 


Octal 


10000 - 
20000 - 
30000 - 
40000 - 
50000 - 
60000 - 
70000 - 


1000 
to 
1777 


(Octal) | (Decimal) 


0000 
to 
0511 
(Decimal) 


Decimal 
4096 
8192 

12288 

16384 

20480 

24576 

28672 


OCTAL-DECIMAL CONVERSION 
OCTAL-DECIMAL INTEGER CONVERSION TABLE 


0267 
0275 
0283 
0291 


0299 0300 


0307 
0315 


0323 
0331 
0339 
0347 
0355 
0363 
0371 
0379 


0387 
0395 
0403 
0411 
0419 
0427 
0435 
0443 


0451 
0459 
0467 
0475 
0483 


0259 0260 


0268 
0276 
0284 
0292 


0308 
0316 


0324 
0332 
0340 
0348 
0356 
0364 
0372 
0380 


0388 
0396 
0404 
0412 
0420 
0428 
0436 
0444 


0452 
0460 
0468 
0476 
0484 
0492 
0500 
0508 


0261 
0269 
0277 
0285 
0293 
0301 
0309 
0317 


0325 
0333 
0341 
0349 
0357 
0365 
0373 
0381 


0389 
0397 
0405 
0413 


0421. 
0429 


0437 
0445 


0453 
0461 
0469 
0477 
0485 
0493 


0501. 
0509 


OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 


2000 1024 
to to 

2777 1535 

(Octal) | (Decima 


Octal Decimal 
10000 - 4096 
20000- 8192 
30000 - 12288 
40000 - 16384 
50000 - 20480 
60000 - 24576 
70000 - 28672 


1542 15 3000 1536 
1550 to to 

1558 3777 2047 
1566_ | (Octal) | (Decimi 


1574 
1582 
1590 
1598 


1606 
1614 
1622 
1630 
1638 
1646 
1694 
1662 


1670 
1678 
1686 
1694 
1702 


OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 


4000 2048 2307 
to to 2315 
4777 2559 2323 


(Octal) |(Decimal) 2331 
2339 


Octal Decimal oo 
10000 - 4096 ae 
20000- 8192 | 
30000 - 12288 | 

40000 - 16384 2371 
50000 - 20480 | 2379 
60000 - 24576 2387 
70000 - 28672 } a 


2411 
2419 
2427 


2435 
2443 
2451 
2459 
2467 
2475 
2483 
2491 


2499 
2507 
2515 
2523 
2531 
2539 
2547 
2555 


5000 2560 2819 2820 
2827 2828 


to to 
5777 3071 2835 2836 
(Octal) | (Decimal) 2843 2844 
2851 2852 


2859 2860 
2867 2868 
2875 2876 


2883 2884 
2891 2892 
2899 2900 
2907 2908 
2915 2916 
2923 2924 
2931 2932 
2939 2940 


2947 2948 
2955 2956 
2963 2964 
2971 2972 
2979 2980 
2987 298 

2995 2996 
3003 3004 


3011 3012 
3019 3020 
3027 3028 
3035 3036 
3043 3044 
3051 3052 
3059 3060 
3067 3068 


OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 


3072. 3073 3074 3075 
3080 3081 3082 3083 
3088 3089 3090 3091 
3096 3097 3098 3099 
3104 3105 3106 3107 
f3112 3113 3114 3115 
3120 3121 3122 3123 
3128 3129 3130 3131 


6000 3072 
to to 

6777 3583 

(Octal) | (Decimal) 


Octal Decimal 


10000- 4096 
3136 3137 3138 3139 Sauer 
3144 3145 3146 3147 40000 - 16384 
3152 3153 3154 3155 50000 - 20480 


3160 3161 3162 3163 
3168 3169 3170 3171 
3176 3178 3179 
3184 3186 3187 
3192 3 3194 3195 


60000 - 24576 
70000 - 28672 


) | 3200 3202 
3208 3210 
3216 3218 
3224 3226 
3232 3234 
3240 3242 
3248 3250 
3256 3258 


3264 3266 
3272 3274 
3280 3282 
3288 3290 
3296 


3840 3841 7000 3584 
3848 3849 to to 
3856 3857 7777 4095 
3864 3865 (Octal) | (Decimal) 


3872 3873 
3880 3881 
3888 3889 
3896 3897 


3588 3589 3590 
3596 3597 3598 
3604 3605 3606 
3612 3613 3614 
3620 3621 3622 
3628 3629 3630 
3636 3637 3638 
3644 3645 3646 


3904 3905 
3912 3913 
3920 3921 
3928 3929 
3936 3937 
3944 3945 
3952 3953 
3960 3961 


3652 3653 3654 
3660 3661 3662 
3668 3669 3670. 
3676 3677 3678 
3684 3685 3686 
3692 3693 3694 
3700 3701 3702 
3708 3709 3710 


3968 3969 
3976 3977 
3984 3985 
3992 3993 
4000 4001 
4008 - 4009 
4016 4017 
4024 4025 


3716 3717 3718 
3724 3725 3726 
3732 3733 3734 
3740 3741 3742 
3748 3749 3750 
3756 3757 3758 
3764 3765 3766 
3772 3773 3774 


4032 4033 
4040 4041 
4048 4049 
4056 4057 
4064 4065 
4072 4073 
4080 4081 
4088 4089 


3780 3781 3782 
3788 3789 3790 
3796 3797 3798 
3804 3805 3806 
3812 3813 3814 
3820 3821 3822 
3828 3829 3830 3831 
3836 3837 3838 3839 


E6 


Octal Decimal 


.001 
.002 
. 003 
.004 
005 
. 006 
.007 
.010 
O11 
012 
.013 
014 
015 
016 
017 


020 
021 
022 
023 
024 
025 
026 
027 
030 
031 
032 
033 
034 
035 
036 
037 
040 
041 
042 
043 
044 
045 
046 
047 
050 
051 
052 
053 
054 
055 
056 
057 
060 
.061 
062 
063 
064 
065 
066 
067 
070 
071 
072 
073 
074 
075 
076 


OCTAL-DECIMAL FRACTION CONVERSION TABLE 


Octal Decimal Octal Decimal 


. 125000 
. 126953 
. 128906 
. 130859 
. 132812 
. 134765 
. 136718 
. 138671 


. 140625 


000000 
001953 
. 003906 
005859 
007812 
009765 
011718 
013671 
015625 
017578 
019531 
021484 
023437 
. 025390 
027343 
. 029296 


- 031250 
- 933203 
. 035156 
. 937109 
. 039062 
041015 
. 042968 
044921 
046875 
. 048828 
. 950781 
. 052734 
. 054687 
. 056640 
. 058593 
. 060546 
. 062500 
. 064453 
. 066406 
. 068359 
070312 
. 072265 
074218 
076171 
978125 
. 080078 
. 082031 
983984 
. 085937 
. 087890 
. 089843 


~ , 091796 


. 093750 
095703 
. 097656 
. 099609 
. 101562 
. 103515 
. 105468 
107421 


. 109375 
» 111328 
. 113281 
~ 115234 
. 117187 
119140 
. 121093 
. 123046 


142578 


. 144531 


146484 
148437 
150390 
152343 


. 154296 


. 156250 
. 158203 


160156 


. 162109 


164062 


. 166015 
. 167968 
. 169921 
171875 
. 173828 
175781 
.. 137734 
. 179687 
. 181640 
. 183593 
. 185546 
. 187500 
. 189453 
. 191406 
. 193359 
. 195312 
. 197265 
. 199218 
201171 
. 203125 
. 205078 
. 207031 
. 208984 


210937 


. 212890 
. 214843 
. 216796 
. 218750 
. 220703 
. 222656 
. 224609 


226562 


. 228515 
. 230468 
. 232421 


. 234375 
. 236328 
. 238281 
. 240234 
. 242187 
. 244140 
. 246093 
. 248046 


. 200 
.201 
. 202 
. 203 
. 204 
. 205 
. 206 
. 207 
. 210 
211 
.212 
213 
.214 
2215 
216 
.217 
. 220 
24 | 
. 222 
. 223 
. 224 
229 
. 226 
ewer 
. 230 
.231 
. 232 
. 233 
. 234 
~ 235 
. 236 
. 237 
. 240 
241 
. 242 
. 243 
244 
. 245 
. 246 
. 247 
. 250 
.2ol 
. 202 
.253 
» 204 
. 255 
. 256 
257 
. 260 
. 261 
. 262 
. 263 
. 264 
. 265 
. 266 
. 267 
. 270 
2271 
2272 
273 
274 
2275 
» 276 
2277 


. 250000 
. 251953 
. 253906 
. 255859 
. 257812 
. 259765 
. 261718 
, 263671 
. 265625 
. 267578 
. 269531 
. 271484 
. 273437 
. 275390 
, 277343 
, 279296 
. 281250 
. 283203 
. 285156 
. 287109 
, 289062 
. 291015 
. 292968 
. 294921 
. 296875 
298828 
. 300781 
, 302734 
. 304687 
. 306640 
. 308593 
. 310546 
. 312500 
. 314453 
. 316406 
. 318359 
. 320312 
. 322265 
. 324218 
. 326171 
. 328125 
. 330078 
. 332031 
. 333984 
. 335937 
. 337890 
. 339843 
. 341796 
. 343750 
. 345703 
. 347656 
. 349609 
. 351562 
.353515 
. 355468 
. 357421 
. 359375 
. 361328 
. 363281 
. 365234 
, 367187 
. 369140 
. 371093 
. 373046 


. 300 
. 301 
. 302 
. 303 
. 304 
. 305 
. 306 
. 307 
.310 
311 
312 
313 
314 
2315 
. 316 
317 
. 320 
321 
. 322 
. 323 
.324 
~325 
. 326 
327 
. 330 
2331 
. 332 
. 333 
. 334 
. 335 
. 336 
. 337 
. 340 
.341 
. 342 
. 343 
. 344 
. 345 
. 346 
347 
. 350 
2351 
~ 352 
.353 
. 354 
.359 
. 356 
357 
. 360 
. 361 
. 362 
. 363 
. 364 
. 365 
. 366 
. 367 
. 370 
371 
2372 
373 
374 
2375 
. 376 
2377 


Octal Decimal 


. 375000 
. 376953 
, 378906 
. 380859 
. 382812 
384765 
. 386718 
, 388671 
. 390625 
. 392578 
394531 
396484 
398437 
. 400390 
402343 
404296 
. 406250 
. 408203 
410156 
412109 
414062 
416015 
. 417968 
419921 
421875 
. 423828 
425781 
427734 
429687 
431640 
. 433593 
435546 
. 437500 
439453 
441406 
443359 


445312 


447265 
- 449218 
451171 


«453125 
» 455078 
. 457031 
. 458984 
. 460937 
. 462890 
- 464843 
- 466796 
. 468750 
. 470703 
. 472656 
. 474609 
. 476562 
~ 478515 
. 480468 
. 482421 
» 484375 
. 486328 
. 488281 
. 490234 
. 492187 
- 494140 
« 496093 
- 498046 


OCTAL-DECIMAL FRACTION CONVERSION TABLE (continued) 


Octal 


. 000000 


000001 


000002 
. 000003 
. 000004 
000005 
. 000006 
. 000007 
000010 
. 900011 
. 000012 
. 000013 
. 000014 
000015 
. 000016 
000017 
. 000020 
000021 
900022 
. 000023 
. 000024 
. 000025 
. 000026 
. 000027 
. 000030 
. 000031 
. 000032 
. 900033 
. 000034 
000035 
. 000036 
. 000037 
. 000040 
000041 
. 000042 
. 000043 
. 000044 
000045 
. 000046 
. (00047 
. 000050 
. 000051 
000052 
. 000053 
000054 
000055 
. 000056 
. 000057 
. 000060 
000061 
. 000062 
. 000063 
. 000064 
. 000065 
. 000066 
000067 
. 000070 
000071 
. 000072 
. 000073 
000074 
000075 
. 000076 
000077 


Decimal 


. 000000 
. 000003 
- 000007 
.000011 
000015 
000019 
. 000022 
. 000026 
. 000030 
. 000034 
. 000038 
. 000041 
. 000045 
. 000049 
. 000053 
. 000057 


000061 
. 000064 
. 000068 
000072 
. 000076 
. 000080 
. 000083 
. 000087 


000091 
000095 
. 000099 
. 000102 
. 000106 
- 000110 
000114 
000118 
. 000122 
000125 


- , 000129 


. 000133 
. 900137 
000141 
. 000144 
- 000148 
000152 
. 000156 
. 000160 
. 000164 
. 000167 
000171 
000175 
. 000179 
000183 
. 000186 
. 000190 
. 000194 
. 000198 
. 000202 
000205 
900209 
000213 
000217 
000221 
000225 
. 000228 
. 000232 
- 000236 
. 000240 


000100 


000101 
000102 
000103 
000104 
000105 
000106 
000107 
,000110 
000111 
000112 
000113 
000114 
000115 
, 000116 
000117 


, 000120 
,000121 
, 000122 
, 000123 
, 000124 
, 000125 
, 000126 
, 000127 
000130 
,000131 
000132 
, 000133 
. 000134 
000135 
. 000136 
, 000137 
, 006140 
, 000141 
, 000142 
, 000143 
,000144 
, 000145 
, 000146 
, 000147 
, 000150 
,000151 
, 000152 
000153 
, 000154 
.000155 
. 000156 
, 000157 
, 000160 
. 000161 
. 000162 
, 000163 


. 000164 


000165 
. 000166 
000167 
000170 
000171 
000172 
000173 
000174 
000175 
000176 
000177 


Decimal 


. 000244 
. 000247 
000251 
000255 
.000259 
. 000263 
. 009267 
. 000270 
000274 
. 000278 
. 000282 
. 000286 
. 000289 
. 000293 
. 000297 
000301 
. 000305 
. 000308 
. 000312 
. 000316 
. 000320 
. 000324 
. 000328 
. 000331 
. 000335 
. 000339 
. 000343 
. 000347 


.. 000350 


000354 
000358 
000362 
000366 
000370 
000373 
000377 
000381 
000385 
000389 
000392 
000396 
, 000400 
000404 
000408 
000411 
000415 
000419 
000423 
000427 
000431 
000434 
000438 
000442 
000446 
000450 
000453 
000457 
000461 
000465 
000469 
000473 
, 000476 
. 000480 
000484 


. 000201 
. 000202 
. 000203 
. 000204 
. 000205 
, 000206 
. 000207 
. 000210 
. 000211 
.000212 
. 000213 
. 000214 
. 000215 
. 000216 
.000217 
. 000220 
. 000221 
. 000222 
. 000223 
. 000224 
. 000225 
. 000226 
. 000227 
. 000230 
. 000231 
, 000232 
. 000233 
. 000234 
. 000235 
. 000236 
. 000237 
. 000240 
. 000241 
. 000242 
. 000243 
. 000244 
. 000245 
. 000246 
. 000247 
. 000250 
. 000251 
. 009252 
. 000253 
, 000254 
. 000255 
, 000256 
, 000257 
. 000260 
, 000261 
. 000262 
. 000263 
. 000264 
. 000265 
. 000266 
. 000267 
. 000270 
. 000271 


000272 


. 000273 
. 000274 
000275 
. 000276 
. 000277 


~ Octal Decimal 


- 000200 © 


. 000488 
. 000492 
000495 
. 000499 
. 000503 
. 000507 
. 000511 
. 000514 
. 000518 
. 000522 
. 000526 
. 000530 
. 000534 
. 000537 
900541 
. 000545 


. 000549 
. 000553 
. 000556 
. 000560 
. 000564 
. 000568 
. 000572 
. 000576 


. 000579 
. 000583 
. 000587 
. 000591 
. 000595 
. 000598 
. 000602 
. 000606 
. 000610 
. 000614 
. 000617 
. 000621 
000625 
. 000629 
. 000633 
. 000637 


. 000640 
. 000644 
. 000648 
. 000652 
. 000656 
. 000659 
. 000663 
. 000667 
, 900671 
. 000675 
. 000679 
. 000682 
. 000686 
. 000690 
. 000694 
. 000698 
000701 
000705 
000709 
000713 
000717 
- 000720 
. 000724 
. 000728 


. 000300 
000301 
- 000302 
. 000303 
. 000304 
. 090305 
. 000306 
. 000307 
.000310 
.000311 
000512 
. 000313 
000314 
.000315 
. 000316 
. 000317 
. 000320 
000321 
. 000322 
. 000323 
. 000324 
. 000325 
. 000326 
000327 
. 000330 
000331 
. 000332 
. 000333 
. 000334 
000335 
. 000336 
000337 
. 000340 
000341 
. 000342 
. 000343 
. 000344 
. 000345 
.00034t 
. 000347 
. 000350 
000351 
000352 
. 000353 
. 000354 
000355 
. 000356 
000357 
. 000360 
. 000361 
. 000362 
. 000363 
. 000364 
. 000365 
. 000366 
. 000367 
. 900370 
. 900371 
. 000372 
. 000373 
. 900374 
. 900375 
. 000376 
. 000377 


Decimal 


. 000732 
. 000736 
. 000740 
. 000743 
. 000747 
000751 
. 000755 
.000759 
000762 
. 000766 
. 000770 
000774 
000778 
. 000782 
000785 
000789 


000793 
000797 
000801 
. 000805 
000808 
000812 
000816 
. 000820 


. 000823 
000827 
. 000831 
000835 
. 000839 
000843 
- 000846 
. 000850 
.000854 
. 000858 
. 000862 
. 000865 
. 000869 
. 000873 
.C00877- 
000881 


. 000885 
. 000888 
. 000892. 
. 000896 
. 000900 
. 000904 
. 000907 
000911 
000915 
. 000919 
. 000923 
. 000926 
. 000930 
. 000934 
. 000938 
. 000942 
. 000946 
. 000949 
. 000953 
. 000957 
000961 
. 000965 
. 000968 
. 000972 


OCTAL-DECIMAL FRACTION CONVERSION TABLE (continued) 


Octal Decimal Octal Decimal Octal Decimal Octal Decimal | 
.000400 ,000976 .000500 .001220 .000600 .001464 .000700 .001708 
.000401  .000980 .000501 .001224 .000601 .001468 000701 ,001712 
.000402 .000984 .000502 =, 001228 .000602 .001472 .000702 .001716 
.000403 .000988 .000503 = 001232 .000603 .,001476 .000703  ,001720 
.000404 .000991 .000504 .001235 .000604  ,.001480 .000704 ,001724 
.000405 ,000995 .000505 .001239 .000605 .001483 .000705 001728 
.000406  .000999 .000506 .001243 000606 .001487 000706 .001731 
.000407 ,001003 .000507 =, 001247 .000607 .001491 .000707 ,001735 
.000410 .001007 .000510 ,001251 ,000610 .001495 .000710 .001739 
.000411  .00101C .000511 .001255 .000611  .001499 000711 ,001743 
.000412 .001014 .000512 .001258 .000612 .001502 .000712  ,001747 
.000413. =, 001018 .000513 = 001262 .000613 .001506 ,000713  .001750 
.000414 .001022 .000514 .001266 ,000614 .001510 000714 .001754 
.000415 .001026 .000515 .001270 000615 .001514 000715  ,001758 
.000416  .001029 000516 .001274 .000616 ,.001518 .000716 .,001762 
.000417 =, 001033 .000517 =, 001277 .000617 ,001522 .000717 .001766 
.000420 ,001037 .000520 =, 001281 .000620 .001525 ,000720 = .001770 
.000421 .001041 .000521  .001285 .000621 .001529 .000721  .001773 
.000422 .001045 .000522 =, 001289 .000622 .001533 .000722 ,001777 
.000423 .001049 .000523 = , 001293 .000623 .001537 .000723 = .001781 
.000424 ,001052 .000524 =, 001296 .000624 .,001541 .000724 -°.001785 
.000425 .001056 .000525 .001300 .000625 ,001544 .000725  .001789 
.000426  .001060 .000526 =. 001304 ,000626 .001548 .000726 .001792 
.000427 ,001064 .000527 001308 .000627  ..001552 .000727  ,001796 
.000430 .001068 .000530 =, 001312 .000630 .001556 .000730  .001800 
.000431 ,001071 .000531 .001316 .000631  .001560 .000731 .001804 
.000432 .001075 ,000532 =. 001319 .000632 .001564 .000732  .001808 
.000433 ,001079 ,000533 =. 001323 .000633 .0015567 .000733. =, 001811 
.000434 ,001083 ,000534 .001327 .000634 .001571 ,000734  .001815 
.000435  .001087 .000535 001331 .000635  .001575 ,000735 .001819 
.000436 .001091 ,000536 .001335 .000636 .001579 .000736 .001823 
.000437  .001094 .000537 001338 .000637 .,001583 .000737  ,001827 
.000440 .001098 .000540 ,001342 .000640 .001586 000740 .001831 
.000441 .001102 .000541 ,001346 .000641  ,001590 .000741  ,001834 
.000442 .001106 .000542 .001350 .000642  .001594 .000742  ,001838 
.000443 .001110 .000543 .001354 .000643 .001598 .000743 ,001842 
000444 ,001113 .000544 ,001358 .000644 .001602 .000744 ,001846 
000445 ,001117 .000545 .001361 .000645 .001605 .000745  .001850 
.000446 ,001121 .000546 .001365 | ,000646  .001609 000746 .001853 
.000447 .001125 .000547 =, 001369 .000647 .001613 .000747 ,001857 
.000450 ,001129 .000550 =, 001373 .000650 .001617 .000750 ,001861 
000451 ,001132 .000551 .001377 .000651 001621 .000751 .001865 
.000452 ,001136 .000552 =. 001380 .000652 .001625 .000752  .001869 
.000453 =, 001140 .000553. = . 001384 .000653 .001628 .000753  ,001873 
.000454 .001144 .000554 .001388 .000654 .001632 .000754 .001876 
000455 ,001148 000555 .001392 ,000655 .001636 .000755  .001880 
.000456 . .001152 .000556 .001396 .000656 .001640 .000756 ,001884 
.000457 =.001155 .000557 + ~=.001399 ,000657 .001644 .000757  .001888 
000460 .001159 .000560 .001403 ,000660 001647 000760 ,001892 
.000461 .001163 000561 .001407 000661 .001651 000761 ,001895 
000462 =, 901167 .000562 .001411 . .000662 .001655 .000762  ,001899 
000463 .001171 .000563 .001415 .000663  .001659 .000763 .001903 
.000464 001174 .000564 .001419 000664 .001663 ,000764  .001907 
000465 .001178 ,000565 .001422 000665 .001667 000765 ,001911 
000466 .001182 .000566 .001426 000666 .001670 © 000766 .001914 
000467 ,001186 .000567  .001430 -000667  .001674 .000767 ,001918 
.000470 .001190 .000570 ,001434 000670  .001678 .000770  ,001922 
.000471 .001194 .000571 .001438 .000671  .001682 .000771  .001926 
.000472 .001197 000572 = .001441 .000672  .001686 ,000772 =, 001930 
.000473 =. 001201 .000573. = 001445 .000673 ,001689 .000773 .001934 
.000474 =, 001205 .000574 .001449 ~ ,000674 =. 001693 .000774  .001937 
.000475 ,001209 ,000575 =. 001453 000675 .001697 ,000775 .001941 
.000476 .001213 .000576 .001457 000676 .001701 .000776 .001945 
.000477 ,001216 .000577 =. 001461 ,000677 .001705 .000777 .001949 
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APPENDIX F 
REFERENCE DATA FOR SYSTEM TABLES 


F.,l INTRODUCTION 


This Appendix provides reference data on the various information 
tables which reside in the MUMPS-1]1 Operating System. These tables 


are physically contiguous and reside in low memory below the system's 
time-sharing Executive (Figure F-1). 


MEMORY 


SYSTEM 
INTERRUPT 
VECTORS 


SYSTEM STACK 
SYSTEM TABLE 
DEVICE TABLE 
SYSTEM TABLES 
UC! TABLE 
PARTITION TABLE 


JOB TABLE 
EXECUTIVE 


REMAINDER OF 
SYSTEM SOF TWARE: 


DATA BASE 
SUPERVISOR 


PARTITIONS 
16K UP TO 128K 
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Figure F-1l Relative Table Position 


These tables are maintained by various routines in the Operating 
System and contain system control and status information including: 
general system configuration data, time and date values, base 
addresses for other tables, I/O device and partition utilization, 
User Directory areas, and job status. All table information is 
essential for system operation. Also, some of this information may 
be especially useful to the MUMPS System Manager/Programmer, 

for developing and troubleshooting MUMPS application system programs 
and the system itself. 


Fol 


Using the special system features of the MUMPS Language which include 
the VIEW Command and the SVIEW function, the System Manager/Operator 
can access and alter table data as required. Modification of internal 
memory (or disk) by careless or inexperienced individuals can have 


disastrous results on system operation. 


The following paragraphs describe the System Table, the Device Table, 
the UCI Table, the Partition Table, and the Job Table. 


The System Table specifies a number of system constants and param- 
eters. The Device Table specifies current I/O device information 
including the device being used ('owned') and devices not physically 
present. The UCI Table contains all legal UCI codes (input during 
system generation or modification) and the addresses of associated 
Global and Program Directories. The Partition Table specifies the 
size and location of each partition in the system. The Job Table 


specifies job status. 


A word of explanation about the term "job" is in order at this point. 
A job as defined by MUMPS-11l is any user activity which requires the 
use of a partition. Thus, logging-in to the system initiates a job. 
A program started in another partition via the START command is also 
deemed a job. 


F.2 THE SYSTEM TABLE (SYSTAB) 


The System Table (Table F-l) is the repository of basic system constants, 
indicators, control information, and special buffer addresses. In 
addition, it contains address pointers to all other system tables. 
This is important to note, since the specific addresses of these 
tables and the System Table itself may change from time to time in 
succeeding versions of the Operating System. Thus access to system 
tables should always be made initially through location 44 (54 octal). 
This location will always contain the base address of the System 
Table. The relative position of System Table entries is also fixed 
so that all tables can be located via location 44 and the System 
Table. 


Example: 
To obtain the address of the System Table, type: 
>SET Az=$V(44) 


To obtain the address of the first entry in the Device 
Table, type: 


>SET B=$V(A+4) 
or to combine the operations: 


>SET A=$V($V(C44)+4) 


Table F-l 


System Table 


A 
(decimal) Contents 


SYSTAB+97 Address of. Job Table (JOBTAB) 
+2 Address of Partition Table (PARTAB) 
+4 Address of Device Table (DEVTAB) 
+6. Base Address of Device Descriptor Buffers (DDB) 
+8 Address of UCI Table (UCITAB) 
+19 Address of Disk Storage Allocation Table 
+12 Address of Garbage Table +2 (disk blocks to be 
deallocated) 
+14 Address of first 256-word buffer in Buffer Pool 
+16 Count of number of illegal interrupts the sys- 
tem has detected | 
+18 Disk block address of data contained in UTLBUF 
(SYSTAB+199@) 
+29 Logical disk number for block in UTLBUF 
+22 Address of Disk Buffer #1 
+24 Address of Disk Buffer #2 
+26 Garbage Indicator (f = no garbage) 
Physical Disk Overflow Switch for Logical Disk 
Y (@ = overflow allowed) 
Number of ticks remaining in this second 
Number of ticks per second 
Number of ticks left in current job's time slice 
Initial value of slice (ticks) for current job 
Number of ticks in basic time slice 
Time in seconds since midnight (high-order bits) 
Time in seconds since midnight (low-order bits) 
Date in the form: (yy*500)+ddd 
where: yy = year -1900. 
| ddd = day count since December 31 
Base address of System Stack 
First available address above device buffers 
Base address of first partition (other parti- 
tions follow sequentially) 
Status Register address of system clock 
Number of job in the run queue on system restart 
Number of job in the disk I/O bound queue on 
system restart 


(continued on next page) 


Table F-1 (Cont.) 


System Table 


Location 
(decimal) Contents 


SYSTAB+48 
+50 
+52 
+55 
+56 
+58 


+61 


+62 
+64 
+66 


+68 
+70 
+72 
+74 
+76 
+78 
+80 
+82 


Line Buffer starting address 

End Address of Symbol Tabletl 

Pointer to Global Directory (3 bytes) 

Physical Disk Overflow Switch (0 = overflow 

allowed) 

Buffer Address given to most recent Job 
in Run Queue 

Address of System Information Block on system 
disk (3 bytes) 

Most recent Job in Run Queue (when 0, job is 
being Swapped out; error not reported until 
next Swap-in) 

Programmer Access Code, initially set 
to CTRL/X CTRL/X CTRL/X 

Disk error tally counter, incremented by 1 for 
each disk I/O hardware error 


Magtape unit 0 buffer address from pool 


Magtape unit 1 buffer 
Magtape unit 2 buffer 
Magtape unit 3 buffer 
Reserved Device #0 
Reserved Device #1 
Reserved Device #2 
Reserved Device #3 
DECtape unit 0 buffer 
DECtape unit 1 buffer 
DECtape unit 2 buffer 
DECtape unit 3 buffer 


address 
address 
address 


address 
address 
address 
address 


from 
from 
from 


from 
from 


from 


from 


pool 
pool 
pool 


pool 
pool 
pool 
pool 


Sequential Disk Processor #0 buffer address 
from pool 

Sequential Disk Processor #1 buffer address 
from pool 

Sequential Disk Processor #2 buffer address 
from pool 

Sequential Disk Processor #3 buffer address 
from pool 

UTLBUF Address of utility buffer (view device) 
from pool 

Magtape Error Count 

DECtape Error Count 

RK11 Disk Error Count __. 

Disk Address of latest error (low order word) 


~RK11 Hardware Status Register 


RF1l1l Disk Error Count 

Disk Address of Latest error 

Disk Address of latest error (high order word) 
RF1l1l Hardware Status Register 


RP11, RP04 Disk Error Count 


Disk Error Address: section in bits 0-3, 
track in bits 8-12 

Disk Error Address: cycle in bits 0-8, drive 
in bits 10-12 


RP11, RP04 Hardware Status Register 


Base Address of Ring Buffer area 
Base Address of Ring Buffer Queue (address of 
next available Ring Buffer) 


(continued on next page) 
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Table F=-1 (Cont.) 


System Table 


| Location 
(decimal) Contents 


SYSTAB+134 Base Address of All Multiplexer DDB's 
+136 End Address of All Multiplexer DDB's 
+138 RP11 Disk Drive Number Remapping Table (each 
byte corresponds to a physical unit (0-7); 
initially assigned to successive logical 
units 0-7 in that order) 

RK11 Disk Drive Number Remapping Table (each 
byte corresponds to a physical unit (0-7); 
initially assigned to successive logical 
units 0-7 in that order) 

Number of Jobs waiting to run 

Write-check Switch (if non-zero, all disk write 
operations will be checked) 

Index into System Bootstrap for Disk Descriptor 
Table 

Low limit address for System Stack (LOWSTK) ; 
normally set to 450, but may be altered 
during system generation. 

Address of First Global Buffer Descriptor 

Address of Interrupt Service Routine for 
Multiplexer 

Multiplexer #1 Hardware Status Register 

Multiplexer #2 Hardware Status Register 

Start Address of Global Disk Buffers 

Count of logical Disk Reads 

Count of Buffer Swaps 

Count of Physical Disk Reads 

Number of job being killed by RSJ 

Number of Bus errors 

TM1L Status Register 

TM11 Command Register 

TM1l Byte Record Counter Register 

TM11 Current Memory Address Register 

TM11 Data Buffer 

TMl11 Read Lines 

DECtape Control and Status Register 

DECtape Command Register 

DECtape Word Count Register 

DECtape Bus Address Register 

DECtape Data Register 

RP1l interrupt Service Address 

RPO04 Interrupt Service Address 

RP1l1l Control Status Register 

RPO4 Control Status Register 

RP04 Disk Drive Number Remapping Table 
(each byte corresponds to a physical 
unit, 0*7, initially assigned to suc- 
cessive logical units 0-7 in that order) 

RP04 Storage Allocation Table Base Address 

TJU16 Control Status 1 Register 

TJU16 Control Status 2 Register 

TJU16 Drive Status Register 

TJU16 Error Register 

TJU16 Tape Control Register 

Magtape Unit 0 Device Descriptor Buffer 
Base Address 


Table F-1 (Cont.) 
System Table 


Location | 
(decimal) Contents } 


SYSTAB+232 11/70 Group of Cache Memory Error Count (1 byte) 


+233 11/70 Group I Cache Memory Error Count (1 byte) 

+234 11/70 Memory Parity Error Low Address Register 

+236 11/70 Memory Parity Error High Address Register 

+238 11/70 Memory Parity Error System Register 

+240 11/70 Memory Parity Error - Job Number of Last 

- Hung Job : 

+242 Multiplexer #3 Hardware Status Register 

+244 Logical Address of Partition Base Address if 
>28K System (24576 or 20480) | 

+246 Address of.EBLMEM Subroutine (used by Bootstrap 
Loader) 

+248 Address of REQJOB Subroutine (used by Bootstrap 
Loader) 

+250 Address of SETJOB Subroutine (used by Bootstrap 
Loader) 

+252 Address of MUMPS#Y Subroutine (used by Bootstrap 
Loader) 

+254 RP02-RP03 Table (each byte corresponds to a unit, 
non-zero implies an RP02, zero implies an RP0O3) 
8 bytes 

+262 Status Register Address for DZ-1l #1 

+264 Status Register Address for DZ=-1l #2 

+266 Status Register Address for DZ-1l #3 

+268 Status Register Address for DZ-1l #4 

+270 Status Register Address for DZ-11l #5 

+272 Status Register Address for DZ-1l #6 

+274 Beginning Address of DZ-11 DDB's 

+276 Pointer to Card Reader Table if One in System. 
Card Reader Table consists of 3 words, as 
follows: 
eWord 0 ; SYSGEN Enters CR-11 CSR Address 
Word 0 ; SYSGEN Enters CR-11 Vector Address 
-Word 0 ; SYSGEN Enters Device Number of 

| Card Reader (must be 51.-54.) 

+278 CSR for DM11-BB Attached to DH11 #1 

+280 CSR for DM11-BB Attached to DHI11 #2 

+282 CSR for DM11-BB Attached to DHI1 #3 

+284 Interrupt Entry Code for DM11-BB #1 
This Location +14. for DM11-BB #2 
This Location +28. for DM11-BB #3 

+286 Communication Device Flag (0=CPU,1=DMC-11) 

+288 Address of DMC-11 Interrupt Service Routine 

+290 Pointer to Last Byte of RJ: Maps in DSKSAT 

+292 Pointer to Last Byte of RK0O6 Map Area in DSKSAT 

+294 RKO06 Drive Remapping Table (each byte corresponds 
to a physical unit (0-7); initially assigned to 
successive logical units 0-7 in that order) 

+302 Address of RK06 Interrupt Service Routine 

+304 Address of Control Status Register for RK06 

+306 Count of RK611 Errors | 

+308 RKO6 Error Address, Sector # and Track # 

+310 RKO6 Error Address, Cylinder # and Drive # 

+312 RKO6 Error Status Register 

+314 RH11/RP04,05,06 Error Status Register (RPER2) 

+316 RH11/RP04,05,06 Error Status Register (RPER3) 
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F.3 DEVICE TABLE (DEVTAB) 


The Device Table (Figure F-2) is a table of byte entries, one for 
each possible I/O device in the system. The first entry in the 

table (DEVTAB+0) specifies the length of the table; all other entries 
are associated with the various I/O devices in the system. Ifa 
device is available, its table entry is zero. If a device is being 
used or is 'owned' by a job, the device entry contains the Job Entry 
Number. The ASSIGN Command is used to place job entry numbers in 
the table. When a device does not exist in the system, its table 


entry is set to -l (equivalent to 3779) « 


UCI CODE - 
UCITAB+O |] CHARACTER 4 


44 | UCI CoDE- 
CHARACTER 2 


42 | UCI CODE- 
CHARACTER 3 


SIZE OF TABLE 
DEVTAB+0O IN BYTES 


DEVICE 1 
DEVICE 2 


DEVICE 3 +3 


GLOBAL 
+4] DIRECTORY 
DISK POINTER 


+5 


+6 
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Figure F-2 Device Table Figure F-3 UCI Table 


F.4 USER CLASS IDENTIFICATION TABLE (UCITAB) 


The UCI Table (Figure F-3) specifies all legal UCI's acceptable to the 
system and the location of the Global and Program Directories associated 
with each. Each entry in the table is three words long. Up to 16 
entries can be made; one for each UCI. These entries are initially 

set by the MUMPS System Generation Program (SYSGEN) and can be 

modified by the Modify System Parameter Program (MSP). The first 

entry in the table is defined as the System UCI or UCI #1. 


The first three bytes of an entry contain the ASCII representation of 
the UCI code. The fourth, fifth and sixth bytes contain information 
which points to a Global Directory. By convention, the Program Direc- 
tory is located in the next contiguous disk block after the Global 


Directory. 


F.5 PARTITION TABLE (PARTAB) 


The Partition Table (Figure F-4) specifies the size and base address 
of each partition defined in the system. The entries in this table 
are set during System Generation’. The table consists of single-word 
entries. The first entry is a header word, the low (even) byte of 
which specifies the standard partition size in 128-word multiples; 

the high byte specifies the maximum number of partitions that can be 
described by the table. At System Generation, the user may specify 

a maximum of 18 partitions for systems with no more than 28K words of 
memory, Or a maximum of 40 partitions with more than 28K words of 
memory. Each of the remaining entries in the table specifies partition 


information. 


The low byte of a partition entry word specifies the size of the 
partition as the number of 128-word increments minus one. For example, 
10° (4,096/128=32; 32-1= 
31). The high byte of the partition entry word contains the high-order 


a 4K-word partition would have an entry of 31 
bits of the partition's base address (location of the first word). 


In systems with no more than 28K words of memory, the knowledgeable 
system manager or operator may examine partitions other than the 

one currently owned. To do so, he calculates a partition's base 
address as described below, and then uses the address with the SVIEW 


function to examine locations in the partition. 


A partition's base address is an integer multiple of 256. Therefore, 
the significant digits of the base address (as stored in a binary 
16-bit word), occupy only the high-order byte of the word. To obtain 
the integer address to use with $VIEW, the system programmer must 
zero (mask) the low-order byte of the partition table entry word. 


Example: 


To obtain the address of Partition 2: 


>SET A=$V($V($V(44)4+2)+4) /25600%25 688 
ee) 


Ee. 
ly r 5 
ean ees 
3 


Ipescribed in the MUMPS-11 Operator's Guide. 
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1. Get the base address of the System Table. 
2. Get the base address of the Partition Table (SYSTAB+2). 
3. Get the entry word for partition #2 (PARTAB+4). 


4. Divide that by 25600 to shift out the low byte (shifts 
one byte to the right). This works because MUMPS trun- 
cates fractional parts to two decimal places and SV 
returns only integers. 


5. Multiply by 25600 to shift one byte to the left to get 
the base address of the partition as an integer for 
later use with SV. 


The memory management characteristics of systems with more than 28K 
words of memory do not allow examination of partitions other than the 


one currently owned. 


Each Partition Table entry corresponds with entries in the Job 


Table (JOBTAB). The job associated with the nth entry in the 


Job Table always uses the partition specifies by the nth 


entry in 

the Partition Table. The value n is always even and in the 

range: (1 through maximum number of partitions )*2. That is, parti- 
tion 2 is the second entry in both tables and its address is ‘Table 
base address +4'. In this way, the value of n can be used for indexed 


accesses both to PARTAB and JOBTAB. 


MAXIMUM NO. OF | STANDARD SIZEIN] | yeaperR 
PARTAB+0 | PARTITIONS (1819 | 128- WORD WORD 
OR 4010) _ INCREMENTS 


HIGH ORDER PARTITION SIZE 
+2 | BYTE OF BASE IN 128-WORD poner 
ADDRESS INCREMENTS (-4) 


BO 


Figure F-4 Partition Table 
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F.6 THE JOB TABLE (JOBTAB) 


The Job Table (Figure F-5) is where all system queve information is 
kept. All system queues are contiguous with the Job Table and all 
entry numbers (job numbers) are relative to the base of the dob Table. 


The low (even) bytes of Job Table entries are used for system queue 
Space and the high bytes for job hung status. If bit 15 of a Job 
Table entry is set, then the job is in a hung state and by defini- 


tion not in a system queue. 


The first word in the Job Table is a header word containing the 


following information: 


(Even) low byte 
(Odd) high byte 


number of currently available partitions 


number of partitions in the system. 


HIGH (ODD) BYTE LOW (EVEN) BYTE 


JOBTAB +0 IN THE SYSTEM CURRENTLY AVAILABLE 
+2 JOB NUMBER 1 ENTRY SPACE 
+4 | io ee we 

+6 
+8 
+10 
+12 
+14 
+16 
+18 
+ 20 
+ 22 
+ 24 
+26 
+28 
+30 
+ 32 
+ 34 

+ 36 (80) JOB NUMBER 18 (OR 4O)ENTRY SPACE QUEUES 

+38 (82) | REAR POINTER FRONT POINTER RUN 

+ 40 (84) | SHORT 

+ 42 (86) DISK 1/O BOUND 

+ 44 (88) DISK RESOURCE BOUND 

+ 46 (90) RING BUFFER RESOURCE BOUND 

+ 48 (92) BUFFER RESOURCE BOUND 

+ 50 (94) WAIT NUMBER 1 

+ 52 (96) : WAIT NUMBER 2 

+54 (98) | ) WAIT NUMBER 3 

+ 56 (100) CLOCK 

+ 56 (102) REAR POINTER FRONT POINTER PARTITION AVAILABLE 


| 
| 
I 
] 
] 
J 
l 
] 
| 
| 
| 
I 
| 
| 
[ 
I 
l 
| 
| 
l 
l 
] 
I 
i 
| 
{ 


Figure F-5 Job Table (JOBTAB) 


F.7 DEVICE DESCRIPTOR BUFFER (DDB) 


Each terminal device that exists in the system (device number 1, 4-19, 
and 64-111) has an associated 16-word device descriptor buffer (DDB). 
DDBs also exist for devices 2 and 3, regardless of whether or not they are 
physically present in the configuration. Their format differs, but 
they can be found using the same formula. The DDB is used to contain 
both static and dynamic terminal device information. The base address 


of a terminal's DDB for devices 1, 4-19 is found as follows: 
DDB Address = ((TRM-1)*32) + BASE 


where: TRM = Terminal's device number 


BASE = Base address of DDB #1 (contained in 
SYSTAB+6 of the system table). 


Table F-2 
Device Descriptor Buffer for Devices 1, 4-19 


WORD Location 
(decimal) (octal) Contents 


Contains a "JSR,R1,ROUTINE" instruction se- 
quence. Where: ROUTINE is the address of | 
the entry point into the device's interrupt 
service routine. 
Address of the device's first receiver 
register. 
Bit setup for receiver status register. 
Bit setup for transmitter status register. 
Terminal error status (SA data). 
Low byte: Horizontal position in the line 
(SX). 
High byte: Vertical position on the page 
(SY). 
Low byt Device status 
>0 
<0 
200 


Input 
Output 
CTRL/O typed - suppress output. 


e: 
0 = No activity 


High byte: Device Information 
Meaning 


Teletype-like terminal 
Video Terminal 

Echo Character 

No echo, no BREAKS 

Device can input or output 
Device can only output 

LP11l line printer 

Modem (DLI1E, DH11, or DZll) 


PRErEOrRFOFO 
Hou wu ue tl 


continued on next page 


Table F-2 (Cont.) 


Device Descriptor Buffer for Devices l, 4-19 


WORD Location 
(decimal) (octal) Contents 


DDB+16 Bit Meaning 


CPU-CPU Device 
Device on a DZ11l MUX 
No parity 
Compute even parity 
(For a VT52, bits 0 and 3 are set.) 
Low byte: character currently being 


5 
6 
7 


HOR - 


echoed. 

High byte: Data set (if present) status 
indicator. 

Low byte: Number of characters +l to 
stall. 


High byte: If CPU-CPU: CRC 

If not CPU-CPU: 
Bits 0-7, character to output 
when stalling. 
Bit 8, "XeuOFF" in effect if 
=l. 

Pointer to last character input from 

ring buffer. 

Pointer to last character output to ring 

buffer. 

Low byte: Partition size 
needed (0 = 
standard size) 

High byte: Index into UCI 
table 

Program name (3 bytes) 

High byte: Right page margin as speci- 

fied in ASSIGN command. | 

Low byte: $B -— Current message counter 

for CPU-CPU Handler. 

High byte: $H -— Temporary variable for 

CPU-CPU Device, VT52 ESC code 
character. 


"Tied" Termi- 
nal Informa- 
tion 


The base address of a terminal's DDB for devices 64-111 is found as 


follows: 


DDB Address = ((TRM-64) *32) + base 
Where: TRM = Terminal's device number 


BASE = Base address of DDB's for multiplexers 
(contained in SYSTAB+134 of the system 
table). 


Table F-3 


Device Descriptor Buffer for Devices 64-111 (DH11) 


WORDS 
(decimal) 


1-2 
3 


Ol & 


~ O07 


Location 
(octal) 


Contents 


Unused. 
Line parameter register. 
Bits 0,1 - Character Length 
00 5 bits 10 7 bits 
01 6 bits 11 8 bits (default-All 
TTY's, LA30, VTOS5) 
Bit 2 -— # Stop bit 
0 - 1 Stop bit 
1-2 for 6-8 bit 
characters, 1.5 for 5 bit characters 
(default). 
Bit 4 - Parity 
0 - Disable (default) 
1 - Enable 
Bit 5 - Type parity (only if bit 4=1; 
ignored if bit 4=0). 
0 - Even 
1 - Odd 
Bits 6,7,8,9 - Receiver speed 
Bits 10,11,12,13 - Transmitter speed 
0 - Zero baud 10 - 600 baud 
50 1200 
75 1800 
110 2400 
184.5 4800 
150 9600 


200 External input 
300 A* 
External input 
B* 
*Special order hard- 
ware. 


SOO Bm WN EF 


Not used. 
Low byte: Use =-l Stuffing buffer for 
output 
=+] Read hung 
= 0 Some other state, 
do not wake on inter- 
rupt 
High byte: MARSW - Set non-zero 
When outputting CR/LF at right margin. 
TRMSA - Error Status of terminal. 
Low byte: $X - Indicates horizontal 
position in the line. 
High byte: SY - Indicates vertical posi- 
tion on the page. 


continued on next page 


Table F-3 (Cont. ) 


Device Descriptor Buffer for Devices 64-111 (DH11) 


WORDS Location 
(decimal) (octal) Contents 


No activity 
Input 
Output 
“0 on to-suppress 
output 
High byte: Cond 10: Information parti- 
cular to this device. 
Bit fe Dg 6 
Video terminal 
Echo char 
No echo and no breaks 
Input/output device 
LP1l 
Modem (DLI1E, DH11l, or 
D211) 
CPU/CPU 
Device on DZ11 multi- 
plexer 
Compute even parity. 
0 No parity check 
For VT52, bits 0 and 3 are set. 
Low byte: Echo - Current char being echoed. 
High byte: DATAST - Dataset status. 
Low byte: Stall - Number of characters | 
(+1) to stall on FF. 
High byte: (Bits 0-7) STCHAR - The charac- 
ter to output when stalling. 
Bit 8 "XOFF" in effect if = 1 
RINGIN — Pointer to last char inputted 
from R.B. 
RINGOUT - Pointer to last char taken from 
RB. 
Low byte: Size - Partition size needed; 
O = Standard 
High byte: UCIn - Number of UCI 
Pname - Program name (3 bytes) 
Low byte: Pname 
High byte: Margin - Right margin, as 
specified in 'ASSIGN' CMMD. 
High byte: VT52 ESC code 


The DDB is found by multiplying the device 
number (SI(JOBASE)) by 32 (bytes), the 
length of the buffer, and adding that to 
the base DDB address (MLXBEG). The routine 
"SETUP" in 'UTIL' does the actual 
calculation. 


DDB+16 Low byte: Status-0 


Bit 


Bit 
Bit 
Bit 


Bit 
Bit 


Bit 


Hol 


Table F-4 
Device Descriptor Buffer for Devices 64-111 (DZ11) 


WORD Location 
(decimal) (octal) Contents 


1-2 DDB+0 Contains a "JSR,R1,ROUTINE" instruction se- 
quence. Where: ROUTINE is the address of 
the entry point into the device's interrupt 
service routine. 

3 +4 Line parameter register. 
Bits 0,1 - Character Length 
00 5 bits 10 7 bits 
O01 6 bits 11 8 bits (default-All 
TTY's, LA30, VTO5) 
Bit 2 — # Stop bit 
0 - 1 Stop bit 
1-2 for 6-8 bit 
Characters, 1.5 for 5 bit characters 
(default). 
Bit 4 - Parity 
0 - Disable (default) 
1 - Enable 
Bit 5 - Type parity (only if bit 4=1; 
ignored if bit 4=0). 


1200 baud 


4 +6 Internal constant 

5 +10 DZ11 CSR Address 

6 +12 Terminal error status (SA data). 

7 +14 Low byte: Horizontal position in the line 
($X). 

High byte: Vertical position on the page 

(SY). 

8 +16 Low byte: Device status 


No activity 

Input 

Output 

CTRL/O typed - suppress output. 
High byte: Device Information 


Meaning 


Teletype-like terminal 
Video Terminal 

Echo Character 

No echo, no BREAKS 

Device can input or output 
Device can only output 

LP11l line printer 

Modem (DLL1E, DH11, or D211) 


PHrHOrFOHO 


APPENDIX G 
SYSTEM DATA STRUCTURES 


Gel INTRODUCTION 


This appendix provides reference information on the various data 
structures used internally by the MUMPS Operating System to con- 
tain user programs and data both in core and on the disk data base. 


G.2 DISK DATA STRUCTURES 


All data stored on the disk is in 256-word (512-byte) blocks. The 
first word and last two words in each block always contain the same 
type of data, even though the rest of the contents of the block may 
differ widely. The first word is a relative pointer to the first 
available byte in the block. If the block contains data, the 

pointer is always 2 or greater, the 2 being necessary to index around 
the first word itself. The last two words contain the continuation 
pointer to the next block in the chain. A pointer value of zero (ff) 


indicates the end of a chain. 


RELATIVE 
POINTER TO FIRST 
AVAILABLE BYTE 
IN THIS BLOCK 


506 (10) BYTES 
FOR DATA 
STORAGE 


CONTINUATION POINTER WORD 254 


TO NEXT 
UNUSED BLOCK WORD 255 
IN CHAIN 


Figure G-l Basic Disk Data Block 


The five kinds of data blocks generally kept on the system disk are 
global data blocks, bit map blocks, program data blocks, Global Direc- 
tory Blocks and Program Directory Blocks. These five types of data 
blocks have a common format, as shown in Figure G-l. In addition, the 
first 104-108 blocks of the system disk contain the system image. The 
contents of these blocks are shown in the system disk block layout 


(Figure G-2). 


SYSTEM Operating System Image 
MEMORY Where: 
IMAGE N = 4 x image size in K words 


N+1 | 
DSKAT — Disk Storage Allocation Table 
SYSB 
N42 | svsetx lt taotas =e Oalmege- Table 
EXTRA Reserved for Additional 
Crash Block Information 
N+3 
CRASH {Crash Block Information 
N+4 , 


N+5 
Any remaining blocks E 
between an image NOS SS ee ee 
size smaller than 96 aaa 
blocks and the directory 
blocks. ds ea Global Directory — 
Established by SYSGEN 
yyy aad Program Directory — 
Established by SYSGEN 
where: 
Disk Type XXX yyy 
RK 102 103 
RF, RS 106 107 
RP, RJ or 108 109 
RM 


Figure G-2 System Disk Block Layout 


G-2 


G.2.l1 Global Data 


Global data are held in four basic ways: single numeric, double 
numeric, string, and 4-word double precision floating-point numeric. 
Further, each can be combined with a pointer. The data type is 
encoded in bits 5 through 7.of the first byte of each global entry. 
Table G~l defines these codes. These are the values returned by the 
$D Function?. 


Table G-l 


MUMPS=-1l1 Data Type Codes 


Undefined variable 

Single numeric 

String 

Double numeric 

Pointer 

Single numeric plus a pointer 
String plus a pointer 

Double numeric plus a pointer | 
4-word floating point numeric? 


OTA AP WHF QW 


A pointer node, if present, points to a block that contains the next 
lower level element in the array. The block can also have a 
continuation pointer in words 254 and 255 that points to more data 
at the same level. To illustrate this, consider the following 


example: 


In the array 'ABC', assume the following elements are defined: 


Variable Contents 
4 ABC 

4ABC (1) "ABC" 
tABC (1,2,1) NAGE" 
tABC(1,2,2) "NAME" 
4ABC (2) "VALUES" 
tABC (2,4) 364.9 
tABC(2,4.5f) 832.81 
+ABC (3,87) N70" 


A diagram of the array tABC is shown in Figure G-3. 


‘Refer to Chapter 4 of the MUMPS-11 Language Reference Manual. 
*Stored internally with a data code of zero. 


G=-3 


FIRST LEVEL OF 
SUBSCRIPTING 


(1 BLOCK ) 
& CH) & (2) & (3) 
"ABC" "VALUES" 

| 

| | 

SECOND LEVEL OF | | 
SUBSCRIPTING ¢é (1,2) | & (2,4) Ca (2,4.50) | Co (3,87) 
( 3 BLOCKS ) | 364.9 832.01 | ay AY a 

| | 


THIRD LEVEL OF 
SUBSCRIPTING (1,2,1) (1,2,2) 
(1 BLOCK ) ar et "NAME" 


(TOTAL NUMBER OF BLOCKS =5, EXCLUDING THE DIRECTORY BLOCK ) 


11- 1421 


Figure G-3 Global Array Structures 


All the data for level 1 are in the same block or in continuation 
blocks (i.e., blocks pointed to by word 255 of the previous block). 
Data for level 2 are pointed to by the data in level 1 and reside 

in a different data disk block. In no case does a disk block contain 


data on more than one level. 


Each mode requires three bytes to specify the data type and subscript. 
The bytes following these are used to store the pointer (three bytes), 
if there is one, and then the data, if any, associated with that node. 
A node cannot exist if it has neither a pointer nor data. Thus, the 

smallest node in the system requires five bytes (either single-numeric 


or null string, and no pointer). 


Figures G-4 through G-10 illustrate all possible configurations of 
global data. 


24BIT 
SUBSCRIPT 


5 BYTES 


SINGLE 
— NUMERIC —— 
DATUM 


11-1423 


(SD () returns 1) 


Figure G-4 Single Numeric Node 


The 'L' and 'H' on the numeric datum (the last two bytes) show how the 
datum is represented internally in a word. That is, when the datum 

is assembled into a word, the first byte becomes the low-order byte 

of the word and the second byte the high-order byte. 


8 BYTES 


SINGLE NUMERIC 
DATUM 


11-1424 


($D() returns 5) 


Figure G-5 Single Numeric with Pointer Node 


21 BIT 
SUBSCRIPT 


7 BYTES 


(SD() returns 3) 


Figure G-6 Double Numeric Node 


A double numeric datum is assembled into a 2-word grouping for 
internal calculations. The first two bytes shown above constitute 
the high-order word of the grouping; the second pair, the low-order 
word. Within each word, the bytes are assembled as for a single 


numeric datum, 


SUBSCRIPT 


POINTER | 
DATUM 


10 BYTES 
6 BYTES 


~ POINTER _ 
_ DATUM 


DOUBLE 
— NUMERIC — 
DATUM 


11-1427 


(SD() returns 4) 


SD () returns 7) 


Figure G-7 Figure G-8 


Double Numeric with Pointer Node Pointer Node 


The three-byte disk pointers are stored with bits 0-7 in the low-byte, 
bits 8-15 in the middle byte and bits 16-23 in the high byte. If 
assembled into two words, the high byte (bits 16-23) of the pointer 
would occupy the low-order byte of the high-order word. The pointer 


bits are assigned as indicated below: 
BENE BL BEN Bd YD Te Dd 0 


Type |Unit Number Block Number on Unit | 


21 BIT. 
SUBSCRIPT 


OFFSET 
ist CHARACTER 
2nd CHARACTER N+5 BYTES 


3rd CHARACTER 
N+1 BYTES 


Nth CHARACTER 


(SD() returns 2) 11-1428 


Figure G-9 
String Node of "N" Characters 
In string data, each character is stored in one 8-bit byte, with a 
null byte ending the string. An offset is stored as a byte at the 


beginning of the string to point to the next string entry. 


21BIT 
SUBSCRIPT 


POINTER 
DATUM 


OFFSET 
N+8 BYTES 


ist CHARACTER 
2nd CHARACTER 


3rd CHARACTER 
N+1 BYTES 


Nth CHARACTER 


11-1429 
EOM=End of message and is held internally 
as a null (0) byte. 


(SD() returns 6) 


Figure G-10 String of "N" Characters with Pointer Node 


A double-precision floating-point numeric datum requires 14 bytes of 
storage. The data type and 21-bit subscript are contained in the 
first three bytes. A pointer datum occupies the next three bytes. 
This entry is always present and contains a 0 if there is no lower 
level. The remaining eight bytes (four words) are used to contain 
the double-precision floating-point number as shown in Figure G-12,. 
This format is identical to that employed by the PDP-1l Floating 


Point Processor (FPP-11B) and the PDP-11 Floating Point Math Package 
(FPMP-11). 


NOTE 


The format is limited to normalized numbers. 
The high-order bit of the mantissa (which is 
always 1) is omitted in order to allow one 
more bit in the exponent field. 


The sign of the number is bit 15 of the first word (word n). When 
this bit is set to zero, the number is positive. When it is set to 
one the number is negative. 


7 
WORD N JSIGN 


WORD N+2 


WORD N+4 


WORD N+6 


Figure G-ll Double Precision Floating Point Format 


The exponent of the number is stored in bits 14 - 7 of word n, using 
excess 128, 4 (200,) notation. The value of the exponent is obtained 


by subtracting 200, from the number formed by these bits. 


The mantissa is stored in the remaining portion of word n and in 
words n+2,-n+4, and n+6 as follows: the high-order portion in 
word n (bits 6 -— 0), the intermediate-order portion in words n+2 


and n+4, and .the low-order portion in word n+6. 


The byte representation of a double-precision floating-point datum 


is shown in Figure G-12. 


21BIT 
SUBSCRIPT 


_{0=nNo pointer) _ 
H) 


( 
(L) MANTISSA,,) 

WORD N 14 BYTES 
( 


0 ovo — 
(L) MANTISSA(3) 
WORD N+6 


WORD N+2 


WORD N+4 


Figure G-12 Double Precision Floating Point Numeric Datum 


G.2.2 Bit Maps 


Bit Maps are used to keep track of which blocks are available for use 
(bit set) and which blocks are in use (bit clear). The exact number of 
maps, words, and the number of bits per word used in a map is dependent 
upon the physical characteristics of the disk being represented. The 
maps are two-dimensional; each word in a map represents a surface ina 
cylinder, and each bit position, starting at bit 0, represents a sector 
(block) on that surface (starting at sector 0). A collection of N con- 
tiguous words describe a cylinder and each map is made up of M complete 
cylinders. The number of maps needed to describe a disk is then the 


total number of cylinders divided by M. 
A graphic representation of the bit maps is shown in Figure G-13. 
G.253 Global Directories 


A Global Directory is created just like any other node. There may or 
may not be a pointer or other data associated with the node. The only 
difference is that the "Subscript" is derived from the ASCII representa- 
tion of the global's name. The pointer is to the first level of that 
particular global. If necessary, the block may have a continuation 


pointer in words 254 and 255 to another block of directory entries. 


The directory block itself is pointed to by bytes 3-5 of the UCI Table 
entry. Byte 3 gives the logical disk number, and bytes 4 and 5 contain 
the block number of the first directory block. 


G.2.4 Program Directories 


A Program Directory is in the form of a single numeric datum with a 
pointer node. The pointer is to the first block of the program, and 
the single numeric portion is the two's complement of the program's 


word count. 
The first program directory block is the next higher adjacent block 


from the global directory block. The global directory block number 
is in bytes 4 and 5 of the UCI Table. 


G-10 


|———_———_— BITS Wine | 


WORD 0 
WORD 1 (1st SURFACE 
INA CYLINDER) 
| 
| 
__| | 
| | | 
= — Oo 
a | ax | oc 
: e.g 
B | O | O 
ie Lu Lu 


177777 (8) WORD 246 
CONSTANTS 
052525 (8) WORD 247 | IN EVERY 
125252 (8) WORD 248 { BIT MAP 
BLOCK 
400001 (8) WORD 249 
NO. OF BLOCKS AVAILABLE IN MAP WORD 253 


WORD 254 
WORD 255 


N = NUMBER OF SURFACES IN A CYLINDER 

M = NUMBER OF CYLINDERS PER MAP 

| = NUMBER OF SECTORS ON A SURFACE 

DISK TYPE | N M NO. OF MAPS PER — DRIVE/PLATTER 
RK 12 2 100 2 
RF 8 128 1 1 
RS 16 128 1 1 
RM 11 6 8 51 
RP 10 20 1 200 (RPO2) 
_ 400 (RPO3) 
RJ 11 38 1 408 


Figure G-13 Bit Map Example 


G-1l 


G.2.5 Programs 


Programs are stored on disk blocks in the same format as they are held 
in the Program buffer (Figure G-14). The Step Number is stored in 

two bytes as a 15-bit positive integer. The next byte is an offset 

to the next Step or Part Number. The text starts in the next byte 

and goes on to an EOM (a null byte). The end of the program is 
denoted by a null byte or by a null byte followed by a -1 byte (this 
is necessary to keep word boundaries intact for data following the 


program buffer). 


Bs shane 2 BYTES 
NUMBER 


OFFSET 


11-1430 


Figure G-14 Internal Program Format 


On the disk, the first word of a block that contains a program is 
always a 2. This simply indicates that the block does not contain 
global data but is being used. The last two words of the block contain 


a continuation pointer to the next block in the chain or a null (0), 
if there are no more blocks. 


G.3 PARTITIONS 


Memory Space above the MUMPS-11 system (executable code and tables) 
is divided into partitions (Figure G-15). The use of memory 
partitioning (as opposed to job swapping to and from secondary 
storage) allows the Executive to switch from one job to another in 
minimal time. Hach job, as it enters the system, is assigned a 
memory partition and the job resides within that partition until 
termination (whether job-controlled or system-controlled). A parti- 
tion is subdivided into four major subsections: 

© Overhead 

© Program Buffer 

© User Stack 

cs) Symbol Table 


LOW MEMORY 


PARTITION 
BASE ADDRESS 


PROGRAM VECTOR 
LINE BUFFER/ 
STRING ACCUMULATOR 


PROGRAM BUFFER 


OVERHEAD— 
(FIXED LENGTH— 
180 WORDS) 


SIZE CHANGES 


DYNAMICALLY 


| SIZE CHANGES 


DYNAMICALLY 


SIZE CHANGES 


SYMBOL TABLE ‘| DYNAMICALLY 


HIGH MEMORY 
11-143! 


Note that while the dtrectton of growth of the Symbol Table tis from 


htgh to low memory, the aetual Symbol Table entries are in ascending 
memory ltocattons. 


Figure G-15 MUMPS-11 Partition Layout 


Geet 


Program Vector 


The Program Vector (Table G-2) 


partition which describes the 


is a section at the beginning of a 


"status' of the job residing in that 
partition. 


G.3.2 Line Buffer/String AC 


The Line Buffer/String AC is a dual purpose buffer, 133 bytes long. 
It serves both as a buffer to contain lines being input or output 
via the terminal and as an accumulator for string expression 
results. 


G.3.3 Program Buffer 


The Program Buffer is the storage area for all Steps and Parts of a 
MUMPS-11 program. The contents of the Program Buffer can be modi- 


fied in Direct Mode by adding and deleting Steps or Parts. In addi- 


tion, commands which cause program loading such as CALL, OVERLAY 
and START affect buffer contents. 
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Table G-2 


Program Vector Layout 


Base address of partition; contains 

address to which control transfers at swap-in 
Temporary location 

Temporary location 

Stack Beginning (always contains a word address): 
pointer to the front of the stack (will be equal 
to or one greater than PV+16) 

Stack Pointer (always contains a word address): 
pointer to next free partition stack location 
(note that the partition stack grows from low- 
memory to high memory) 

Line Pointer: 

points to current location in the line buffer/ 
string accumulator 

Character Pointer: 

points to current interpreter character location 


Program Pointer: 
contains address of current Step (SL) 


New Step Pointer: 

pointer to the next available location (byte) 

in the program buffer 

Program Header: 

points to the beginning of the partition's 
Program Buffer 

Symbol Table beginning: 

points to the first byte of the last (top) entry 
in the local Symbol Table 


Principal I/O Device: 

identification number of principal device for current 
job 

Command: 

identifier for command currently being executed 

FOR Switch: 

Counter of the number of levels of nested FOR Commands 
on current line 

Indirection switch: 

Counter of the number of levels of indirection (+) 

on current line 

Global Header: 

pointer to most recently referenced Global Header Block 
Global Block: : 

pointer to most recently referenced Global Data Block 


(continued on next page) 
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Table G=2 (Cont.) 


Program Vector Layout 


Library Global Switch: 
set non-zero if a Library Global is the last 
referenced global 
Argument Switch: 
byte which indicates whether or not a command has 
arguments (@ = no). 
Program Name (3 bytes): 
name of the program currently in the user's 
partition 
User Code (l byte): 
User identification number (set at Sign-on) 
Index into UCI table 
I/O device (1 byte): 
identification number of device currently 
assigned (SI) 
IF switch (1 byte): 
value (true or false) of the most recent IF 
command expression 
Job Status Word: 
bit @ = programmer mode, when set (i.e., Login with 
bit 1 = software BREAK check; PAC) 

set = got BREAK 


bit 2 = external break enable/disable; 
set = enable 
bit 3 = CTRL/C received on terminal 
bit 4 = timed READ overrun 
bit 6 = Write via VIEW enabled 
bit 7 = Library Program and Global Write enable 
bit 12 = (delayed) 11/70 parity error in partition 
bit 13 = swap error 
bit 14 = delayed disk I/O error (error on 
submerged write) 
bit 15 = hardware break interrupt check; 


set = got interrupt 
SE System Variable 
SW System Variable 


As shown in Figure G-16, the Program Buffer is byte-oriented. Entries 
consist of the Step Number in the first two bytes (a 15-bit positive 
integer in the range §-327.67), followed by an offset which points 

to the beginning of the next Step. The remainder of the entry 
consists of up to 132 bytes containing the characters in the Step. 

The last byte of an entry is always.a null which is the internal 


representation of an EOM. 


The last byte entry in the Program Buffer contains one of the fol- 


lowing two data values: 


a. £ if the Program Buffer is an even number of bytes in total 
length (in fact, the @ is the null at the end of the last 
Step), or 


b. 377 if an extra byte is needed to pad the Program Buffer to 
be an even number of bytes. 
These conditions are necessary because the User Stack, which follows 
the Program Buffer, must begin on a word boundary. 
G-15 


-PROGRAM 
BUFFER 


STEP 
2 BYTES 
NUMBER 


OFFSET 


FIRST STEP 


2 BYTES 
NUMBER 
OFFSET 


LAST STEP 


END OF 
377 BUFFER 
p= a : 


11-1432 


Figure G-16 Program Buffer Layout 


G.3.4 User Stack 


The User Stack dynamically increases and decreases in size relative 
to the requirements of the current Job. Its base address and hence 
the whole stack as a block, shift as a program increases or decreases 
in size, since the stack always follows the Program Buffer. 


G.3.5 Free Memory 


The area between the User Stack and the Symbol Table is defined as 
Free Memory. The amount of Free Memory available at any one time is 
contained in the $S System Variable. The Free Memory area is used to 
permit expansion of the dynamic areas of the partition. The Program . 
Buffer and User Stack grows from and shrinks back to the low end of 


Free Memory. The Symbol Table grows from and shrinks back to the 
high end of Free Memory. 
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G.3.6 Symbol Table 


The Symbol Table contains entries for all defined local variables, 
subscripted or unsubscripted. Its size varies as variables are 
defined (SET Command) and deleted (KILL and XKILL Commands) by the 
job running in the partition. The top of the Symbol Table (i.e. 
next available byte for an entry) is pointed to by PV+2f. A Symbol 
Table entry is variable length. The entry descriptor defines the 
fields of the entry. Decimal numbers in MUMPS-11 are manipulated 
as 2-word quantities; however, they are stored as l-word quanti- 


ties in a Symbol Table entry if their range is 4327.67. 


The maximum range of numbers is 4+21474836.47. String data in the 
Symbol Table is followed by a null byte to indicate EOM. Arrays 

are stored in the Symbol Table as ordered (but sparse) elements. 
Subscripts are 21-bit quantities, hence the largest subscript is 
20971.51. Arrays in the Symbol Table have an associated simple 
variable preceding them. This simple variable (having the same 

name as the subscripted variable) contains a pointer around the 

array (to facilitate table searches) and may also contain a string 

or numeric data. Thus, a subscripted variable array with only a 
Single element has an associated simple variable which may or 

may not be explicitly defined. Entries in the Symbol Table for each 
array element, therefore, do not include the array name, but only the 
subscript value followed by associated data. The code bits (high 
order three bits of the first byte of a Symbol Table entry) determine 
the type of entry in the table, as shown in Figure G-17. 


O SINGLE 
BONNER? ie ae 1 NUMERIC 
REARY 1 DOUBLE 


2 Sm (5 aa Oe 
1 STRING O STRING 
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Data Code Description 

G GY gg 4 word floating point numeric! 
g g ui Single numeric (signed 15-bit) 
g 1 g String 

g i 1 Double numeric (signed 31-bit) 
1 g g Array offset 

1 g 1 Array offset and single numeric 
1 1 g Array offset and string 

1 1 1 Array offset and double numeric 


lReported as $D()=8 
Figure G-17 MUMPS-11 Symbol Table Data Codes 
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Double numeric data are stored in the symbol table in the following 
order: 


high-order word 


low-order word ( 


Figures G-18, G-19, and G-20 show the formats of the various types 
of data entries in the Symbol Table. 


BYTE ENTRIES 
LOW MEMORY 


VARIABLE ‘A’, 
SINGLE-NUMERIC 
VALUE 


VARIABLE 'STR’, 
STRING VALUE 


NULL BYTE AT 
END OF STRING 


(L) VARIABLE ‘'xyY', 
DOUBLE- NUMERIC 
hon VALUE 
(H) 


(L) 
(L) 
(H) 


SYMEND 


HIGH MEMORY 


11-1437 


NOTE 


Assuming an empty Symbol Table as an tnitial 
condition, the entrtes tn the table above could 
have been made by the following command string: 


>SET XY¥2425.83,STR="SOMETHING"™ ,A=5 


Figure G-18 Symbol Table Containing Three (Simple) Variables 
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BYTE ENTRIES 
SYMBEG 


LOW MEMORY 


VARIABLE ‘I’ 
SINGLE NUMERIC 
VALUE 


— - OFFSET -- 
(1549) 


ARRAY ‘ABC' 
WITH ELEMENTS 
ABC (1) 

ABC (2) 

ABC (3) 


HIGH MEMORY 


NOTES 


above symbol table could have resulted from 
following command string: 


>FOR JTilsi:3 SET ABC(I)=10*I1 


There ts no datum associated wtth the array 
name. 


The array offset ts a count of the number of 
bytes contatned tn the array. 


Figure G-19 Symbol Table Containing a Simple Variable and 3-Element Array 
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BYTE ENTRIES 


Hee Oa ae 
ae 


ARRAY ARRAY 
OFFSET OFFSET 


TT 24 , 500,638.06 
ist ELEMENT 
ist ELEMENT 


ARRAY 'ABC' WITH AN ARRAY'LMN' WITH AN ARRAY ‘XYZ WITH AN 
ASSOCIATED SINGLE- ASSOCIATED STRING ASSOCIATED DOUBLE- 
NUMERIC VALUE VALUE NUMERIC VALUE 


11-1438 


NOTES 


The datum assoctated wtth.the array name may have been deftned 
(as a stmple variable) etther before or after the array was 
deftned. 


Thts datum ( single-numertc, string, or double-numertc) tmme- 
dtately follows the array offset, preceding the first element 
tn the array. 


The array offset (byte count) tneludes the number of bytes of 
data assoctated with the array name. 


If the array ts KILLed, the datum associated wtth the array nan 
ts also KILLed. 


Figure G-20 Array Entries Having a Datum Associated with the Array Name 
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APPENDIX H 
CRC REFERENCE SUBROUTINE 


CPUNSC RSTS MACRO YVMO2-10 LO "OCT75 OG517206 FAGE 29 

CPU SUBROUTINES AND UTILITIES 
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9 9 

10 SENTRY $ 

Li 9 C(R3)=CHARACTER 

12 3 Ri FOINTS TO THE 00M 

13 sEXIT? 

14 y R3 INCREMENTED BY ONE 

15 3 

146 O3412 CROAK ¢ 

17 O3412 010046 MOV ROy- CSF) ISAVE KR 
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21 03424 016100 MOV CRO CRI) s RO 9GET FREVIOUS CRC 
000016 
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27 03446 012705 MOV #FL20001 RS gSET UF SOURCE 
120001 

28 O3452 004767 JSR FC» XOR gXOR THEM 
000024 
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30 03460 001367 BNE 1 $ 
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100200 
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54 03474 O124605 MOV (SF) +eRS RESTORE RS 
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37 9 KK KKK KK 

38 3 
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44 03506 040500 BIC RO» RO 


45 O35190 0524600 RIS CSF +9 RO 
4&6 03512 000207 RTS BC 
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APPENDIX | 
WRITING AND INTERFACING I/O DEVICE DRIVERS 


I.1 INTRODUCTION 


The MUMPS-11 system provides the user with the option of expanding the 
system's configuration with up to four additional devices, which may 
be assigned to the reserved device numbers 51-54. However, if the card 
reader is to be installed as part of the system configuration, device 
number 54 will be assigned to the card reader. This will mean that de- 
vice number 54 cannot be assigned to another user device. The user 
must write his own device drivers in the MACRO Assembly Language to 


handle the I/O operations associated withthe additional devices. 


A MUMPS-11 I/O device driver follows certain system naming conventions 
and uses several MUMPS system (global) routines to perform standard 
operations. The following paragraphs are intended to provide the appli- 
cation system programmer with the information necessary to write a de- 
vice driver using these conventions and routines. A knowledge of MACRO- 


11 Assembly Language is assumed?. 


If more than one kind of device is to be added to the system, the user 
must write a separate driver for each particular device. Furthermore, 
he will also have to write the routines for associating the device num- 


ber with the appropriate driver. Refer to paragraph 1.4 for details. 


Object modules of all user-written device drivers must be incorporated 
(linked) into the MUMPS system during system build. The MUMPS-11 Opera- 


tor's Gutde describes the linking procedure. 
T.1.1 Device Driver Functions and Routines 
The primary functions of an I/O device driver include: 


@® initializing the driver when the device is ASSIGNed 
@e handling any special device functions made with an ASSIGNment 


e setting up buffers for the temporary storage of data during 
I/O transfers 


‘Por details on the MACRO language, the user may refer to the MACRO-11 
Assembly Language Programmer's Manual (DEC-11-OMACA-A-D). He may also 
find the appropriate PDP-11 Processor Handbook and the PDP-11 Pertpherats 
and Interfactng Handbook useful. 


ii. 


@® answering calls from the MUMPS-11 Language Interpreter to 
perform an I/O operation 


e transferring data from a device's buffer to a user's 
program partition buffer and vice versa 


@ servicing device interrupts 
@® reporting error conditions 


@e cleaning up when the device is UNASSIGNed 


These functions correspond, in general, to the types of routines 


which must be included in the driver. 


In order to interface properly with the MUMPS system, the driver 


must include at least six routines: 


@® an initialization routine named RESASG 
e a clean-up routine named RSUASG 


@e an input handling routine--named by system convention 
XXXIN (where XXX is a 1 to 3-character mnemonic 
for the device) 


@® an output handling routine--named by convention XXXOUT 
® an error reporting routine--named by convention XXXSA 


@e device interrupt service routine (s) 


All routines, except the interrupt service routines, are called by the 
MUMPS-11 Language Interpreter when processing the job currently in the 
Run Queue. The specific routine called depends on the I/O operation 


requested by the job. 


The distinction between the routines called by the Interpreter and 
the interrupt service routines is important. If not written as 
distinct routines, a job might enter an indeterminate state if a 
process initiated from one set of routines is interrupted from the 
other before the first processing is finished. The user should 
note, therefore, that jobs may be "hung" only from Interpreter- 
called routines and "waked" only from interrupt processing routines 


(see paragraphs 1.2.4 and 1.3.2). 


Interpreter receives 
ASSIGN command and --> Calls driver routine 
links logical I/O RESASG 


section with driver? 


Calls system routine 
INPUT or INPUTH, or 
OUTPUT or OUPUT1 which, 
in turn, calls the 

driver routine XXXIN 
or XXXOUT 


READ, LOAD, WRITE 


Interpreter receives e 
TYPE or PRINT command 


Driver receives control 
until I/O tranfer is 
complete* and reports 
error status in SA 


Interpreter receives . Calls driver routine 


UNASSIGN command RSUASG 


Figure I-l Driver Operation 
I.1.2 System Global Variables and Routines 


The driver uses several global system routines and variables 

when handling standard operations. Table I-1 lists the global 

system routines and variables which may be used by either Interpreter- 
called routines or interrupt service routines. Table I-2 lists 


the globals which may only be used by Interpreter-called routines. 


The global routine named QJOB which "wakes" a job may only be 


called by interrupt service routines (see 1.3.2). 


1The logical I/O section re-establishes the link each time the 
job which issued the ASSIGN command is swapped-in until the 
device is UNASSIGNed. 


*On input, driver retains control until the entire line is packed 
into the partition's line buffer. Output may be submerged 
depending on the device and buffer structure. 


Table I-l 


Global Routines and Variables 


LBSIZE (byte) The maximum number of characters that 
a driver may put in the current job's 
line buffer; the maximum size of a 
line input (132,59). 


ILGINT (word) The number of illegal interrupts which 
have occurred in the system. The 
driver should increment the location 
each time it detects an illegal interrupt. 


The interrupt priority level used to 
shut out interrupts. Only necessary 
for Interpreter-called routines to 
avoid race conditions (interrupt 
processing routines are normally 
entered at level 6). The driver may 


raise the priority level before 
making checks which may hang the job 
by issuing the instruction: 
MOVB #INHIB,PSW 
DEVTAB The device table (see Appendix F) 
JOBTAB The job table (see Appendix F) 


SAVREG | Routine which saves registers RO-R5 
(see I.3) 


RES REG Routine which restores registers 
RO-R5 (see I.3) 


NUMAC (2 words) The two-word numeric accumulator 
(see I.2.1.1) 


Table I-2 


System Global Variables and Routines Called by 
Interpreter-called Driver Routines 


LINPTR (word) The partition overhead location 


LBHDR (word) 


SI (byte) 


JBSTAT (word) 


TMP1 (word) 


SA (2 words) 


CURRX (byte) 


CURRY (byte) 


LBOV 


ADREVL 


DIV100 


RBREQ 


RTNRB 


(indexed by R4) which contains 

the address of the line buffer 
within the partition (see I.2.4 and 
Pee Dy 


The base address of the line buffer 
in the current job's partition 
(see 1.2.4 and 1.2.5). 


The partition overhead location 
(indexed by R4) which contains the 
number of currently ASSIGNed device. 


The partition overhead location 
(indexed by R4) which contains the 
job's status (SJ) (see 1.2.4.2). 


The partition overhead location 
(indexed by R4) which contains the 
time interval on a timed READ. 


The SA System Variable (see 1.2.6). 


The $X System Variable. The driver 

can calculate $X on output if applicable 
to the device. It is handled like SA 
and should be in the XXXSA routine 
(Le26)i< 


The SY System Variable; same as 
CURRX above. 


The terminal error message processed 
by the system for line buffer overflow. 
The driver may issue it as illustrated 
below, where R5 contains the character 
count: 


CMPB #LBSIZE,R5 ;too many characters? 
BGE ERROR 


ERROR: LBOV ;yes, terminal error 


Routine which checks for ASSIGN command 
arguments (see 1.2.1.1). 


Routine which divides contents of NUMAC 
by 100 (see I.2.1.1). 


Routine which requests a ring buffer 
from the system's buffer pool (see 1.2.3.2). 


Routine which returns a ring buffer to the 
pool (see 1.2.3.2). | 


(continued on next page) 
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Table I-2 (cont. ) 


System Global Variables and Routines Called by 
Interpreter-called Driver Routines 


Routine which transfers one line from 
the job's output buffer to the device's 
buffer (see I.2.3.5). 


Routine which transfers one line from 
the device's buffer to the job's line 
buffer (see 1.2.3.4). 


UNPACK 


DQJOB Routine which hangs a job (see 1.2.4.1). 


CLKIOR Routine which hangs a job for a timed 


READ (see 1.2.4.2). 


SWPOUT Routine which hangs a job for a time 
Slice. No calling conditions other 
than it must be called at. priority 
level 6. The programmer may not 
assume that any registers are intact 


on return. Calling sequence: 


MOVB #INHIB,PSW 
JSR PC,SWPOUT 
RESDEV First of 3 words in IOD module into 
which reserved device handler must 
enter the addresses (in stated order) of 


RESDEV: XXXSA 
+2: XXXIN 
+4: XXXOUT 


routines. These are the locations which 
tie the system routines ‘INPUT and 
"OUTPUT' to the appropriate routine in 
the user-created driver. 


I.2 INTERPRETER-CALLED ROUTINES 
I.2.1 Device ASSIGNment--Routine Name: RESASG 


The system calls the driver when the Interpreter receives an 

ASSIGN command for the driver's device. This allows the driver to 
perform any initial operations that may be necessary. For example, 
the terminal driver initialization routine turns off the CTRL O 
feature if it was in effect and processes a right margin specification 
if it is present in the ASSIGN command. If there are several 

reserved device drivers, the routine would also direct a call to the 


appropriate driver for the ASSIGNed device (see I.4): 
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ad 


The routine to process the ASSIGN for a reserved device must be named 
RESASG and be defined by a .GLOBL statement in the device driver. 
RESASG must perform the operations necessary to initialize the driver 


and the device for the following conditions: 


a. the device is not already 'owned' by the job 
b. the device is already 'owned' by the job. 


On entry to the routine, R5 contains the device number in its low 
byte, the exit is accomplished via a 'RTS PC' instruction sequence. 


No return conditions are necessary. 


Le2od~ed Handling Optional Syntax on the ASSIGN Command 


The ASSIGN command may contain information that the driver must 
process. For example, an ASSIGN command for a DECTape device may 
contain the byte address for the I/O operation. The system's 
global routine ADREVL is used to look at the character immediately 
following the device number in the ASSIGN statement, and to set the 
appropriate condition codes. The command line is currently in the 


partition's line buffer. 


Routine Call: 


JSR PC,ADREVL ;no entry conditions 
Return: 
ss ;no colon argument present 
0 ;the colon argument is False 


= ;the colon argument is True (returns 
a non-zero value) 


No register may be assumed to be intact on return. 


If the driver needs the actual numeric value of the optional 

ASSIGN command argument for further processing, it must call the. 
system's global routine DIV100 to divide the number by 100, since 
it being carried as a MUMPS integer. DIV100 places the result in 


the numeric accumulator. 


Routine Call: 


JSR PC,DIV100 ;no entry condition 

Return: 
NUMAC ;contains high-order numeric value 
NUMAC+2 contains low-order value 


No registers may be assumed to be intact on return. 


EXAMPLE : 
The following code sequence sets the right margin on a terminal. 
MUMPS command line: A 1:72 


Driver ASSIGN Code. 


.GLOBL ADREVL,DIV100,NUMAC 


MOV R1,-(SBP) ;save address of device descriptor 
sbuffer (DDB) for terminal 

JSR PC,ADREVL ;get optional argument 

BGE DONE |. ;if there is none, quit 

JSR PC,DIV100 ;otherwise divide argument by 100 

MOV (SP)+,Rl1 ;get the DDB address saved 

MOVB NUMAC+2,MARGIN (R11) ;set user-specified margin 


I.-2.2 Device UNASSIGNment--Routine Name: RSUASG 


The driver is called when the Interpreter detects an UNASSIGN 
command for that driver's device to allow the driver to perform 
any necessary clean-up operations. For example, when the terminal 
driver's RSUASG routine is called, it sets up a wait condition to 
allow any current operation to finish (Since in this case, output 
may be submerged), returns the ring buffer to the system's buffer 
pool, and resets the right margin to zero. 


Any device driver must have a global routine named RSUASG, even if 
it is only a return to the caller. On entry to the routine, R5 
contains the device number in the low byte. Return is through 


RTS PC, and no special conditions are necessary. 


I.2.3 Buffers 


A programmer may provide temporary storage space for I/O data in one 


of three ways: 


1. include the necessary buffers within the driver itself 
2. request 64-character ring buffers from the system's pool? 


3. use the 512-character buffers automatically provided by 
the system from the system's buffer pool 


The system supplies the addresses of buffers obtained from the buffer 
pool in System Table entries SYSTAB+76 (device number 51), SYSTAB+78 
(device number 52), SYSTAB+80 (device number 53), and SYSTAB+82 


(device number 54). 


I.2.3.1 Internal Buffers - If the programmer includes buffers within 
the driver and is not going to use buffers from the system buffer pool, 
the driver routine RESASG must pass the buffer address to the system 


when the device is ASSIGNed. The code is: 
MOV #BUFADR, @2 (SP) 


When the device is UNASSIGNed, the RSUASG routine must remove the 


buffer address from the system as follows: 
CLR@2 (SP) 


I.2.3.2 64-Character Buffers - If the programmer wishes to request 
a 64-character buffer from the system, the driver competes with terminal 
drivers for buffers. Each ring buffer is 64 bytes (32 words) long. 
The last 6 bits of a buffer's starting address contain zeroes. The 
last location in a buffer, therefore, is the starting address plus 


7796 


The driver must request a 64-character’buffer and pass the buffer 
address onto the stack when the RESASG routine is called, and return 
the buffer to the pool when the RSUASG routine is called. The driver 
uses the global routine RBREQ to request a 64-character buffer. 
This routine returns the buffer address in register 5 (R5). This 
address must be placed on the stack. The calling sequence is: 

~GLOBL RBREQ 


JSR PC,RBREQ 
MOV R5,@2(SP) 


‘Buffers obtained from the system's buffer pool must be allocated 
during system generation. 
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All registers are destroyed. If no buffer is available, the job is 


hung in the proper buffer resource bound state until one is available. 


The driver uses the global routine RTNRB to return the buffer when 
the device is UNASSIGNed. The driver must pass the address of the 
buffer to RTNRB in R5. The calling sequence is: 


~GLOBL RTNRB 


JSR PC,RTNRB | 
CLR @2(SP) >-R5 has been set to buffer address before this 


I.2.3-3 512-Character Buffers - If the driver within RESASG did not 
allocate a buffer as described in 1.2.3.1 or 1.2.3.2, the system 

will then allocate a 512-character buffer to the driver when the 
device is ASSIGNed and will automatically return the buffer to the 
pool when the device is UNASSIGNed. The driver competes with magtape, 
DECtape Sequential Disk Processor, and VIEW (disk) command devices 
for buffers. Each buffer is 512 bytes (256 words) long and always 


starts on a word boundary. 


I.2.3.4 Unpacking Buffers - The global routine UNPACK takes a line 
from the device buffer and puts it into the buffer to which RO 
points. Lines are terminated by legal ASCII line terminators: LINE 
FEEDS (12,9). vertical TABs (13,,)), and FORM feeds (14,,). 
RETURNS (15,6) are ignored. A null (0) causes a return with the N 


Carriage 
bit set. A single call can unpack a maximum of 132 characters. 


To call UNPACK: 
@e the address of the line buffer into which the characters 
are to be inserted must be in RO 
@ a pointer to a 2-word block (in the driver) must be in R2; 


--word 1 contains a pointer to the device buffer from 
which characters are to be taken 


--word 2 contains a negative count of the number of bytes 
left in that device buffer. 


Calling Sequence: 


~GLOBL UNPACK 
JSR PC,UNPACK ;RO and R2 already set up 


On return, the driver may expect: 


@® a pointer in RO to the next free location in the line 
buffer just packed 


e the words pointed to by R2 updated: 


--word 1 points to the next character to unpack from 
the device buffer 


--word 2 contains the updated negative count (0 if 
the buffer is empty) 


@ the condition codes indicate the following: 


--Z bit set means that the exit was successful (i.e., a 
line terminator was encountered) 


--N bit set means line buffer overflow (i.e., no line 
terminator encountered) 


-—-no bits set means that the buffer is full 


e Rl, R3, R4, R5 are the same as on entry; R2 is destroyed 
I.2.4 Interpreter Call for Input--Routine Name: XXXIN 


When the Interpreter detects a READ or LOAD command in the current 
job, it does a JSR PC,INPUT to the logical I/O section of the 

system module IOD. The logical I/O section does a JSR PC,XXXIN to 
the I/O driver which was linked to the job when the ASSIGN command 


was issued. 


The driver routine may expect the following conditions to exist when 


it is called: 


@e the base address of the partition in R4 


e the address of the user partition line buffer in the globally- 
tagged location LBHDR in the MUMPS Executive 


@e two entries on the stack: the return address to the logical 
I/O section and the value for a timed READ (see below). The 
programmer should pop both of these entries off immediately 
to enable eventual return directly to the Interpreter and 
handle timed READs if necessary. If timed READS are to be 
processed, the second entry must be used as described in 
I.2.4.2. 


MUMPS expects the following conditions when the driver returns to 
the Interpreter: 


@e the base address of the partition in R4 (Same as entry) 


@e the base address of the user partition line buffer in the 
globally-tagged location LINPTR in the user partition 
overhead. The code is: 


~GLOBL LBHDR,LINPTR 
MOV LBHDR, LINPTR(R4) 


@e the complete line of input in the user partition line 
buffer (1.2.3.4). This line may contain not more than 
132, 4 7-bit ASCII characters (one per byte) terminated 
by a null (0) byte. 


e the current error status in the SA System Variable 
(see I.2.6). 


I.2.4.1 Hanging a. Job on Input - In order to allow other MUMPS jobs 
to run, the driver should hang a job when the complete line of input 
is not in the driver's buffer and some device activity (e.g., tape 
rewind) is required to obtain the data. The driver accomplishes this 
by passing a word to DQJOB in R5 which contains a unique hang code 
for the device. The word should be in the form: 


@e bit 15 set to l--indicates that the job is I/O hung 
e bits 14 through 8 contain a unique code 


e bits 7 through 0 set to 0--the system will put a job 
number in these bits 


NOTE 


The following codes for bits 14-8 are 
already assigned and must not be used: 


140000, -- terminals 


142000, -- magtapes 


8 


144000, -- DECtapes 


8 
The driver's interrupt service routines should then request the 
Executive to return a job to the run queue when the required device 
activity is completed (see I.3.2). The driver can therefore assume 
upon return from DQJOB that the buffer is full or that a line 
terminator has been received. 


Example: 


The following two instructions hang a job until terminal I/O is 


finished. 


HANG: .GLOBL DQJOB 


MOV #140000,R5 ;terminal hang code 
JSR PC,DQJOB shang the job until I/O is done 
(BR MORE) 7;gO0 get more characters 


I.2.4.2 Handling Timed READS - Although the timed READ syntax is 
primarily intended for terminals, any device may use it. Upon entry, 
the driver can expect the second entry on the stack to contain the 
time interval specified with the READ; if there is none, the stack 


entry is 0. 


If the job needs to be hung to wait for input, the driver must put 
the job in the clock gueue rather than the I/O bound queue, by 
calling the CLKIOR global routine. By convention, the driver must 
return a null line to the job and set bit 4 in the SJ System 
Variable (global tag JBSTAT) if a timed READ fails. 


CLKIOR returns to the driver on one of three conditions: 


e a full buffer was input from the device 
e a line terminator was received from the device 


@e the specified time was up 


The first two conditions must be detected by the interrupt service 


routine which must, in turn, Signal the executive as shown in I.3.2. 


The driver must distinguish between the first two conditions and 
the third. 


Example: 


Suppose that the driver set a word labelled "INPUT" to a non-zero 
value if some data was received from a device; the driver did not 
pop entries off the stack upon entry. The following code sequence 
will perform a timed READ. 


.GLOBL CLKIOR,JBSTAT,LBHDR 


MOV 4(SP),R5 ;non—-zero time interval? 

BEQ HANG ;then go to HANG (as above) | 

JSR PC,CLKIOR ;else, hang job in clock queue 

TST INPUT ;did any input occur? 

BNE MORE ;yeS-~go process it 

BIS #20,JBSTAT(R4) ;no=-—-set bit 4 in SJ 

MOV LBHDR, RO ;reset to beginning of line buffer 


CLRB (RO) ;return null string 
(go to normal exit) : 


Due to a time-sharing conflict, the system may wake a job prematurely 
that was hung for a timed READ. The time interval, stored in TMPl 
in the partition's overhead, will not be zero. The following code 


expands the previous example to avoid a premature wake condition. 


~.GLOBL CLKIOR,TMP1,JBSTAT,LBHDR 


MOV 4(SP) ,R5 *snon-zero time interval? 
BEQ HANG 
TIMHNG: JSR PC,CLKIOR | ;hang job for time out 

TST INPUT ;did any input occur? 

BNE MORE >yes, go process it 

MOV TMP1(R4),R5 -did timed READ time out? (0) 

BNE TIMHNG ;go hang for remainder of 
time 

BIS #20,JBSTAT(R4) ;time overrun, set bit 4 
in $J 


MOV LBHDR, RO 
CLRB (RO) ;return null string 
(go to normal exit) 


I.2.4.3 Sample Input Routine Flowchart 


Note: Portions shown in dashed 
lines are required only 


if timed 'READ's' are 


DQJOB 
HANG JOB 
I/O BOUND 


REQUEST 
INPUT 
FROM 
DEVICE 


DEVIC 
BUFFER 
MPTY? 


HANG JOB 
1/O BOUND 


/ pact alien: © 
__ CLKIOR _\ 
/ HANG Jog \ 


\ FOR TIMED , 
a dol 
y JX. eX 
, f \ 
7 “ Yi 
Son ’ TIME ~N 
“INPUT? a UP? 7 
4 Se 
Y Y 
PUT CHARACTER 
INTO LINE 
BUFFER 
Y 
SET LINPTR= 
LINE BUFFER 
ADDRESS 
N 
one FORCE EOM 
BUFFER Siac 
LBOV ERROR 


FULL? 


RTS PC 


I.2.5 Interpreter Call for Output--Routine Name: XXXOUT 


The dispatch to the output routine is the same as that for input, 
except that it is called when the Interpreter detects a TYPE, PRINT, 
WRITE or output in a READ command; they all require the same driver 


activity. 
The driver may expect the following conditions upon entry: 


e R4 contains the base address of the partition 


@e RO contains the address plus one of the line buffer 
that contains the line to be output 


e R3 (low byte) contains the first character to be output 
e the return to the logical I/O section on the stack 
(may be discarded immediately) 


MUMPS expects the following conditions when the driver returns: 


e R4 contains the base address of the partition (same as entry) 


e the base address of the line buffer in the word labelled 
LINPTR in the partition overhead; thus: 


~GLOBL LBHDR,LINPTR 
MOV LBHDR,LINPTR(R4) 


e the latest error status in the SA System Variable 
I.2.5.1 Hanging a Job on Output 
The driver needs to hang a job on output only when: 


e the device is currently output active and, therefore, the 
output buffer is busy, or 


e there are more characters to go out than there is room in 
the output buffer (for example, the terminal driver hangs 
the job if there are more than 64 characters in the 
output message). 


The driver may, therefore, submerge a significant part of the output. 
Whenever the message length exceeds the buffer length or previous 
output is unfinished, however, the job must hang to allow other 
MUMPS jobs to run by using the routine DQJOB, as described in 
paragraph 5.8.4.1. 


I.2.5.2 Sample Output Routine Flowchart 


ENTRY - 


KILL ANY 
INPUT 
DEVICE 
BUFFER sna 
OUTPUT 


FULL? 


HANG JOB 
I/O BOUND 


PUT CHARACTE 
INTO DEVICE 
BUFFER 


START 
OUTPUT IF 
NECESSARY 


SET LINPTR= 
LINE BUFFER 
ADDRESS 


GET NEXT 
CHARACTER 


I.2.6 Error Reporting--Routine Name: XXXSA 


The driver must set the SA System Variable to the current error 


status at three different times: 


@ when MUMPS calls XXXSA when the device is ASSIGNED 


e when the job is swapped in and the device is still 
current (device number in SI) 


® when the driver finishes I/O processing in the 
XXXIN and XXXOUT routines 


SA may contain two different kinds of information: 


r -) error status 


@ byte or block address 


The terminals and magtape use SA only as an error status register. 
DECtape uses SA to contain the current byte address. The sequential 
disk processor uses SA both as an error status register and to 


contain the current address, through not at the same time. 


SA is a 2-word system variable which is treated as a 2-word numeric 
value. SA is a global tag; the variable itself is in the system 
module IOD. 


SA -- high-order word 
SA+2 -- low-order word 


Since $A is a numeric value, it must fall within the range of 

legal MUMPS numbers, when multiplied by 100 (4+21474836.47). The 
programmer should, therefore, take some care when putting information 
into the high-order word of SA. For example, it is not possible 

to put a device status register which uses bit 15 as an error bit 


in the word SA; it must go in SA+2 or be split between the two words. 


On entry to the XXXSA routine from the system, the device number 
will be in the low-order byte of Rl. Return is through RTS PC, 


and no return conditions are expected. 


I.3 INTERRUPT SERVICE ROUTINES 


When the system receives a device interrupt, it calls the driver's 
I/O interrupt service routine. What each routine must do is entirely 
dependent on the device. Two general considerations for both the 
input and output processing routines are: error checking and deciding 


when to inform the system that I/O is complete. 


When the system calls the routine, it accesses the driver through 
the device's interrupt vector. The driver does not know the system 
status; in particular, it does not know whether or not the job 


Owning the device is in the system's Run Queue. 


It is suggested that the processor priority level be raised to 6 on 
any interrupts by setting the second word of the device vector to the 
appropriate psw value (e.g., 300.) « The Interrupt Service Routine 
should be brief because interrupts from other devices are shut out 


during interrupt processing. 


The driver must first save the registers using the global routine 
SAVREG. The driver must restore the registers immediately before 
the exit RTI by using the global routine RESREG. The calling 
sequence is the same for both routines: 


JSR RO,SAVING 
-and- 
JSR RO, RESREG 


I.3.1 Error Reporting 


The driver reports error conditions in the SA System Variable. 
Interrupt processing routine, however, cannot put the error codes 
directly into $A because the requesting job may not be in the Run 
Queue. The routine should save the error code in a location unique 
to the device, for example, each terminal has a "Device Descriptor 
Buffer" (DDB) to carry this information. The XXXSA routine then 
puts the error code in $A when the job is waked. In general, an 
error should terminate any input or output and wake the job although 
the driver performs more sophisticated error-handling procedures, 
such as performing retries, etc., if the nature of the device 
warrants them. 
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I.3.2 Waking the Job 


When I/O completes or an error occurs, the driver's interrupt service 
routine must request that the job be placed in the system's Run Queue. 
This operation is the complement of hanging a job in Interpreter- 


called routines. 


The interrupt service routine calls the global routine QUJOB to wake a 
job. QJOB expects the job's number in the low byte of R5 and the 
hang code (as specified to DQJOB) in the high byte of R5. 


Given that the driver knows the device number, it may obtain the job 
number from the system table DEVTAB. The following example wakes the 
job owning the interrupting device, and assumes that R5 contains the 


device number. 


~GLOBL DEVTAB ,QUOB 

MOVB DEVTAB (R5),R5 ;put job number in R5 (note 
that the high byte of R5 is 
always 0 because the job 
number is positive) 

BIS #HNGCOD,R5 sput hang code in high byte 

JSR PC,QJOB s;wake the job 


There is no I/O hung code when a job is hung on a timed READ. The 
following example passes the correct information to QJOB when waking 


a job from a timed READ. 


~-GLOBL DEVTAB, JOBTAB, QUOB 


MOVB DEVTAB(R5) ,R5 . ;put the job number in R5 

TST JOBTAB (R5) sbit 15 is 0 if in timing state 

BPL WAKJOB 

BIS #HNGCOD,R5 ;put hang code in high byte 
WAKJOB: JSR PC,QJOB ;wake the job 


If the driver calls QJOB and the job is not hung, the system ignores 
the call. The interrupt processing routines may, therefore, wake the 


job at any time. 
I.4 DRIVER INTERFACING 
A driver is connected to the system software in three ways: 


1) The RESASG and RSUASG routines are globally linked 
to the system's I/O driver module at system 
build time. 


2) The XXXIN, XXXOUT, and XXXSA routines. are connected 
to the system in the RESDV table in the IOD module, 
in one of two ways: 


a) automatically by ‘once only' initialization code 
in the driver itself probably executed upon the 
first ASSIGN after system startup. 


b) manually by using Mini-ODT to patch memory after 
system generation. 


3) The interrupt service routines are connected to appro- 
priate interrupt vectors in core memory: 


a) automatically by absolutely defining the contents 
of the vector before assembly via the .ASECT 
pseudo-op, or 


b) manually by using Mini-ODT to patch the vector after 
system generation. 


Although there are four reserved device numbers, 51-54, the system 
provides direct interfacing for only one driver. If more than one 
driver is necessary, the user must write dispatch routines to match 
the device number with the correct driver. This applies to all 


routines for each driver except the interrupt routines. 


The device number specified in the ASSIGN command is either in R5 or 

in SI(R4) in the partition overhead. XXXIN, XXXOUT and XXXSA get the 
device number from $I. RESASG AND RSUASG get the device number from the 
low byte of R5. 


For example, assume that a card reader has been assigned to device 
number 51 and a cassette to 52. User-written drivers for both have 
been linked into the system. The following code performs the correct 
dispatch from RESASG. CDASG is the ASSIGN routine for the card reader 
and is physically located in the card reader driver. CSASG is the 


ASSIGN routine for the cassette driver, and is located in that driver. 


.GLOBAL CDASG, RESASG 


RESASG: CMPB #51.,R5 ;compare card reader device number 
in R5 
BNE CSASG ;if not equal, go to cassette 
driver routine 
JMP CDASG ;otherwise, go to card reader routine 
CSASG: 7 ASSIGN routine for the cassette 


The following example shows a dispatch for card reader and cassette 
input routines. The general input routine was linked into the system 
as RESIN. The card reader input routine is CDIN,; the cassette input 


routine is CSIN. 
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.GLOBL CDIN,SI 
CMPB #51.,$I1(R4) 
BNE CSIN 

JMP CDIN 


SA system variable, 3-8, 3-12, 
3-13, 3-14, 3-16 through 
3-23, 3-25, 3-28, 3-29, 
3-31 through 3-35, 3-38, 
5-1, 5-2, F-1l, F-15 

CPU-CPU device, 3-32, 3-33 
Magnetic tape, 3-28 
terminals, 3-12 

Abbreviation of commands, 2-8, 
5-11 

Access codes, 2-5 

Address pointers, F-2 

ALT MODE, 2-4, 3-10 

AND operator, 5-1, 5-2 

Angle brackets, 

communication messages, 4-12 
prompting symbol, 2-6 

Application programs, 1-1ll 

Argument list, optional, 2-8 

Arrays, 1-3, 1-4, 1-12 

storage, G-17 

ASCII code, B-l 

nonprinting, 3-5 

ASR-33 Teletypes, 1-1, 1-7, 
3-9 

ASR-35 Teletypes, 1-1, 1-7 

ASSIGN command, 2-11, 3-1, 3-2, 
3-7, 3-13, 3-16 through 
3-21, 4-5, 5-1, F-5, I-7 

Assignment of I/O devices, 3-2 

Automatic data mode conversion, 
2-10 


SB System Variable, 3-37, F-12 
Backslash (\), xiv, 2-4 
Bars, vertical, xiv 
Base address, F-2 
Baud rates, 2-3 
BCS (Broadcast program), 1-14 
Bit assignments, 
SA, 3-11, 3-20, 3-27 
$J, 5-2 
Bit manipulation, 5-2 
Bit maps, G-10, G-1ll 
Bit masks, 5-1, 5-2, 5-19 
values, 5-1 
Blocks, disk, G-l, G-2 
Boolean AND, 5-1 
Braces ({}), xiv 
BREAK, Xiv, 3-12 
Break button on Teletype, 2-4, 
3-10 
BREAK command, 5-3, 5-9 
Broadcast Program (BCS), 1-14 
Buffer layout, G-15, G-16 


INDEX 


Buffers, 
DECtape, 3-15, 3-16 
driver, I-9 
magtape, 3-16, 3-17 
unpacking, I-10 
64-character, I-9 
128-character, I-10 


Calendar Date subroutine (%D), 
4-5 
CALL command, 2-12, 5-10 
Caretaker Reporter program 
(KTR), 1-14 
Carriage RETURN, 2-4, 3-10 
Carriage RETURN/LINE FEED, 3-5 
Changing program name, 2-14 
Changing programs, 2-13, 2-14 
Character deletion, 2-4 
Characters, 
form control, 3-5 
keyboard control, 2-4 
total number output, 3-7 
Characters and functions, 
special, 
CPU-CPU device, 3-29 
DECtape, 3-16 
line printer, 3-14 
Magnetic tape, 3-16 
paper tape reader/punch, 3-13 
sequential disk processor, 
3-34 
terminals, 3-9, 3-10 
Character set, B-l 
Classes of users, 1-4 
Colon use in commands, 2-9 
Command abbreviations, 2-8, 5-11 
Command and function syntax 
rules, 
summary, 2-8 
Command, conditional execution 
of, 2-9, D=-2 


Command separation from argument, 


2-8 
Commands, I/O device, 
CPU-CPU device, 3-8, 3-29 
DECtape, 3-15, 3-16 
DMC-11, 3-40 | 
line printer, 3-14 
magnetic tape, 3-17 
paper tape reader/punch, 3-13 


sequential disk processor, 3-34 


terminals, 3-9 
Comments, 2-8 
Communication, user to operator 
(ZOP), 4-12 
example, 4-13 


Index-1 


INDEX (CONT. ) 


Compatibility, magnetic tape/ 
DOS-11, 3-17 
label, 3-19 
Concatenation of lines, 3-5, 3-6 
Conditional execution of 
commands, 2-9, D-2 
Configuration, see Hardware 
Conserving memory, 5-9, 5-10 
Control characters, special 
keyboard, 2-4, 3-13 
Control codes, magtape, 
summary, 3-19 
Conversion, automatic data 
mode, 2-10 
Conversion, octal/decimal, 
4-12 
Conversion tables, mathematical, 
E-1 
CPU-CPU device, 3-29 through 
3-34, F-12 
CRC (Cyclic redundancy check) , 
3-30, 3-31, Appendix H 
Creating programs, 2-10 
CTK (System Caretaker program) , 
1-14 
Current devices, 
CTRL/C, 2-4, 
CTRL/O, 2-5, 
CTRL/Q, 3-10 
CTRL/S, 3-10 
CTRL/U, 2-5, 3-10 
Cyclic redundancy check, 
calculating, Appendix H 
CPU-CPU device, 3-30 
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4-l1, 


3 
3-10, 
3-10 
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DAT (Date routine), 1-14 
%D (Date subroutine), 1-15, 
4-5 
Data, 
formatting, 3-5 
I/O, 3-4 
management, 1-3 
mode conversion, 
2-10 
output, 3-4 
processing, 1-2 
protection, 1-4 
structures, G-l 
Data Base Supervisor, 
1-12 
Data, global, G-3 
Datasets, 3-12, 3-13 
Data transmission protocol, 
CPU-CPU device, 3-29 
Date subroutine (%D), 1-15, 4-5 
DBT (Disk Block Tally program) , 
1-14 


4-1, 


automatic, 


1-9 Lael; 


DDB (Device Descriptor Buffer), 


F-11 through F-15 
Debugging, 1-1ll, 2-12, 
Decimal numbers, G-17 
DECtape, 3-15 

buffers, 3-16 
DECwriter, 3-9 
Deletion of, 

line, 2-5 

programs, 2-13, 

Single character, 
Device, 

assignments, I/O, 3-2 

characteristics, 3-8 
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2-14 
2-4 


descriptor buffer (DDB), F-1l 


through F-15 
drivers, I-1l through I-3 
not available, 3-1, 4-9 
ownership, 3-1, 3-2 
supervision, 1-10 
table, I/O, 3-3, 
Device, 
current, 3-2 
dummy, 3-2 
peripheral, 1-1 
principal I/0, 3-2, 3-4, 
Device Assignment (RESASG) 
routine, I-6 
Device numbers, 3-1, 3-2 
CPU-CPU device, 3-29 
DECtape, 3-3, 3-15, 
line printer, 3-3, 
DMC-11, 3-40 
magnetic tape, 3-3, 3-17 


3-4 


3-16 
3-14 


paper tape reader/punch, 3-3, 


3-13 


sequential disk processor, 3-3, 


3-34 through 3-37 
terminals, 3-2, 3-3 
Device Table (DEVTAB), F-7 
Device UnassSignment (RSUASG) 
routine, I-8 
Direct mode, I-2, 2-5 
command entry, 2-7 
command execution, 
log-in/log-out, 2-7 
Directories, 
global, G-10 
program, G-10 


2-8 


G-l, G-2 


packs, 1-12 


Disk Block Dump program (DMP), 


1-14 


Disk Block Tally program (DBT), 


1-14 
Disk data, 
management, 
structures, 


l=3 
G-1l 


Index-2 


3-8 
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Disk packs, 1-12 

Distribution, system, 1-5 

DMC-11 (Communications Controller), 
3-40 

DMP (Disk Block Dump program), 
1-14 


DO command, 2-13 
DOS-11 compatibility, magnetic 


tape, 3-17 
label, 3-19 
Double numeric data, G-3, G-6, 
G-7 
Double-precision floating point 
numeric data, G-8, G-9 
Downward pointer, 5-14, 5-17 


Driver interfacing, I-20 
Drivers, I-l, I-2, I-3 
Dummy devices, 3-2 


SE system variable, 3- 3-15, 
5-1, 5-4 through 5 
Editing globals, 4-21 
Editing program lines, 4-17 
Editor, 4-16 
Entering commands, direct mode, 
2-7 
ERASE command, 2-14 
Erase program line or characters - 
see Deletion 
Error conditions, 
CPU-CPU device, 3-8, 
DECtape, 3-8, 3-16 
disk, 3-8 
DMC-11, 3-40 
line printer, 3-8, 3-15 
magnetic tape, 3-8, 3-19 
operating system, 2-14, 3-7 
paper tape reader/punch, 3-8, 
3-12 
sequential disk processor, 
3-37 
terminals, 3-8, 3-12 
utility programs, 4-4 
Error detection, Library Utility 
Programs, 4-4 
Error messages, C-l 
Error message output device, 
3-2 
Error processing, 2-14, 3-8, 5-4 
Error processing routines, the 
writing of, 5-4 
Error reporting, 
SA system variable, I-18 
Interrupt Service Routines, 
Errors, 
fatal, 3-8 
nonfatal, 3-8 


8, 
-6 


3-32 


3-8, 
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ESCape key, 2-4, 3-10 through 
3-12 

Evaluation rules for expressions, 
2-10 


Exclamation point (!) as termi- 
nator, 3-5 

Executive, 1-9 through 1-11 

Expression elements, 2-10 

Expression evaluation rules, 
2-10 


SEXTRACT function, 5-14 


FD Fast Program Directory Lister, 
1-15, 4-5 
Fatal errors, 3-8 
FILE pnam command, 
FILE command, 2-14 

Filing library program, 4-3 

Fixed head disks, 1-12 

Format control, line printer, 
3-14 

Formatting output data, 3-5 

Form feed, 3-5 

Free memory, 5-10, G-16 

Function and command syntax 
rules, summary, 2-8 

Function nesting, 2-9 

Functions, special for devices - 
see Characters and functions, 
special 
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Garbage chain, 1-12 
Garbage Collector routine, 1-12 
%$GD (Glcbal Directory Lister), 
1-15, 4-5 
%GL (Global Lister), 
Global, 
access, 5-12 
arrays, 1-3 
data, G-3 
data retrieval, 5-7 
design, 5-13 
directories, G-10 
files, 5-11 
variables and routines, 
1-12, I-3 
Global Directory Lister (%GD), 
1-15, 4-5 
Global Lister (%GL), 
Global File Restore (%GR), 
4-8 
Global File Save (%GS), 
4—8 
Globals, Library, 4-16 
Global Place routine (%GP), 


1-15, 4-6 


1-11, 


1-15, 4-6 
1-15, 


1-15, 


1-15 


Index-3 


INDEX 


Global Trace (%GT) library 
utility program, 1-15, 4-8 


Global Utilization program (%GU), 


1-16, 4-9, 4-11 

Global View program (%GV), 1-16, 
4-9, 4-10 

Glossary, A-1l 

GO command, 5-9 

GOTO command, 2-13, 5-8 

%GP (Global Place routine), 
1-13, 1-15 

%GR (Global File Restore), 1-15, 
4-8 

%GS (Global File Save), 1-15, 
4-8 


GT (Global Trace program), 1-15, 


4-8 

%GU (Global Utilization), 1-16, 
4-9 

%GV (Global View), 1-16, 4-9 


SH System Variable, 3-11, 3-12, 
3-37, F-12 
Hanging a job, 
in input, I+12 
on output, I-16 
Hardware configuration, l-l, 
1-2, 1-4 
minimum, 1-5, 1-6 
optional, 1-7 
Hardware status register, 
magtape, 3-21 
paper tape reader/punch, 3-13 
Hung state, 1-9, 1-10, I-12 


$I System Variable, 3-2 
IF command, 5-7, 5-8 
In core job communication, 3-38 
through 3-40 
Indirection syntax operation, 
2-9, 5-11 
Indirect mode, 1-2 
command execution, 2-8 
log-in, 2-5, 2-6 
log-out, 2-6, 2-7 
operation, 1-4 
Information tables, F-l 
Input call routine, I-1ll 
Input data, 3-4, 3-5 
Input-output (I/O), 
commands, 3-4, 3-5 


device assignments, 3-2 through 


3-4 
device characteristics, 3-8 
device numbers, see Device 
numbers 
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Input-output (Cont.), 
device, principal, 3-2, 3-4, 
3-7, 3-8 
device supervision, 1-10 
device table, 3-3, 3-4 
hung state, 1-9, 1-10 
Monitor, 1-10 
Input routine flow chart, I-15 
Interlock, program, 3-2 
Internal buffers, I-9 
Interpreter, 1-10, l-ll 
Interpreter-called routines, 
I-6, I-7 
for input, I-1l through I-14 
for output, I-16, I-17 
Interrupt Service Routines, I-19 
Interrupts, user-controlled, 5-3 
IN USE message (%IU) library 
utility program, 1-16, 4-9 
I/O devices - see Device 
IO (I/O device assignment sub- 
routine), 1-16, 4-1, 4-9 
I/O device drivers, I-1l through 
I-3 
$IU (IN USE message program) , 
1-16, 4-9 


SJ System Variable, 3-8, 5-1 
through 5-3 

Job communication, 3-38, 3-39 

Job (definition of), F-2 

Job priority, 1-8 through 1-10 

Job scheduling, 5-12 

Job Table (JOBTAB), F-9 


Keyboard control characters, 2-4 

Key globals, 5-17 

KTR (Caretaker Reporter program) , 
1-14 


LA30/LA36 DECwriters, 2-2, 3-9 
Language Interpreter, 1-10, 
1-11 
Library Globals, 4-16 
Library Utility programs, 1-13, 
1-15, 1-16, 4-1 through 4-3 
Calendar Date subroutine (%D), 
4-5 
developing and filing, 4-3 
error detection, 4-4 
Fast Program Directory Lister 
(SFD), 4-5 
features, 4-1 
Global Directory Lister (%GD), 
4-5 


Index-4 
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Global Lister (%GL), 4-6 

Global Restore (%GR), 4-8 

Global Save (%GS), 4-8 

Global Trace (%GT), 4-8 

Global Utilization (%GU), 4-9 

Global View (%GV), 4-9 

IN USE Message (%IU), 4-9 

I/O device assignment sub- 
routine (%I0), 4-9 

Octal/Decimal conversion 


(OD), 4-10 
Program Directory Lister (%PD), 
4-12 


Program Load (%PL), 4-13 
Program Save (%PS), 4-14 
running, 4-3 
starting, 4-3 
stopping, 4-4 
summary, 4-2, 4-3 
Time of day subroutine (%T), 
1-16, 4-15 
User to Operator Communicator 
(SOP), 4-10 
Line, 
concatenation, 3-5, 3-6 
deletion, 2-5 
terminators, 2-4, 3-5 
Line Buffer String AC, G-11 
Line feeds, 3-7, 3-10 
Line printer device status 
register, 3-14 
Line printer models, 3-14 
Linking procedure for device 
_ drivers, I-1 
Listing globals, 4-6 
Listing global names, 4-5 
Listing program names, 4-5 
LOAD command, 2-12, 3-4, 3-5 
Loading programs, 2-11, 2-12 
from PS created tape, 4-14 
Local data, 1-3 
Lock, overrun, 5-4 
Logical errors, magtape, 3-22 
Log-in, 
direct mode, 2-7 
indirect mode, 2-6 
preliminary operations, 2-2 
processing, 1-10, 1-11 
to system, 2-2, 2-5 through 
2-7 
Log-out from system, 2-7 


Magnetic tape, 3-16 
compatibility with PDP-1l, 
DOS-11, 3-16, 3-17, 3-26 
control codes, 3-18, 3-26 
errors, 3-8 
Management of data, 1-3 


Maps, bit, G-10, G-ll 
Margin control, 3-7 
Masking, 5-1, 5-2, 5-19 
Mathematical Tables, E-1l 
Memory, 1-2, 1-3, G-12, G-16 
conservation, 5-9 through 5-11 
Message format, CPU-CPU device, 
3-30 
state, 3-29, 3-30 
terminator, 3-31 
transmission count, 3-31 
Messages, explanation of, C-l 
Mixed mode operations, 1-2 
Modes of operation, 1-2 
direct, 1-2, 1-4, 2-6 through 
2-8 
indirect, 1-2, 1-4, 2-6 through 
2-8 
Modification of program, 1-11 
MSP (Modify System Parameters) 
program, 1-14 
Multiple arguments, 2- 
Multiple commands, 2-8 
Multiple user access, 3-1 
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Naked syntax, 1-12 
Naming Library Utility Programs, 
4-3 
Nonprinting ASCII codes, 3-5 
Nesting, 
of commands, 5-11 
of functions, 2-9 
Numbers, I/O device - see Device 
numbers 
Numeric arguments, 3-4 
?nve string, 3-5, 3-6 


OD (Octal/Decimal conversion) 
library utility program, 1-16, 
4-1, 4-10 

Operating system, 1-2, 1-9 

memory size, 1-2 
error processing, 2-14 

Operator precedence, 2-10 

Optional argument list, 2-9 

OP (User to Operator communica- 
tion) program, 1-16, 4-10 

Output formatting, 3-5 

Output routine flow chart, I-17 

Overlay command, 5-10 

Ownership of device, 3-1, 3-2 


PAC (Programmer Access Code), 
1-4, 1-10, 2-1, 2-6, 2-7, 4-1 
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Page feed, 3-5 
Paper tape punch, concatenation 
on, 3-5, 3-6 
Paper tape reader/punch, 3-13 
Parentheses with function argu- 
ments, 2-9 
Partition layout, 5-10 
Partitions, 1-2, F-8, G-8, G-12 
Partition size, F-7 
Partition table (PARTAB), F-8, 
F-9 
Part numbers, G-12 
SPD (Program Directory Lister), 
1-16, 4-14 
PDP-11, 1-1 
Percent symbol (%), 4-1 
Peripheral devices, 1-1 
SPIECE function, 5-14 
PL (Program Load), 1-16, 4-14, 
4-15 
Pointer node, G-6, G-7 
Pointers, 
address, F-2 
downward, 5-14, 5-17 
Precedence of operators, 2-10 
Principal I/O device, 3-2, 3-4, 
3-8 
PRINT command, 3-5 
Printing, suppression of, 2-5 
Priority, job, 1-8 
Program, 
buffer, 5-11, G-12 
changing, 2-13 
comments, 2-8 : 
creation, 1-2, 2-10 
debugging, l-ll, 5-9 
deletion, 2-13 
directories, 4-1, G-10 
execution mode, 1-2 
interlock, 3-2 
loading, 2-11, 2-12, 4-3, 4-4 
modification, 1-11 
name change, 2-14 
normal stop, 2-13 
refiling, 2-13, 2-14 
segmentation, 5-10, 5-12 
Size, 5-9 through 5-12 
Space reduction, 5-12 
start/stop, 2-13, 4-3, 4-4 
storage, 2-11, G-12 
vector, G-13 through G-15 
Program Directory Lister (%PD), 
4-14 
Program Load (%PL), 4-14, 4-15 
Programmer Access Code (PAC), 
1-4, 2-1, 2-6, 2-7, 4-1 
validity check, 1-10 
Programming techniques, Chapter 
5 (5-1) 
Program Save (%PS), 1-16, 4-15 


Programs, Library Utility, 1-13, 
1-15, 1-16, 4-1 through 4-3 
PS (Program Save), 1-16, 4-15 


? (Question mark character) 
used in formatting, 3-6 


READ command, 3-4 
Reader/punch, 3=13 
Recording mode, magnetic tape, 
3-16 
Reducing program space, 5-11 
Reference data for system 
tables, F-l 
Refiling programs, 2-13, 2-14 
Restore Devices program (RST), 
1-14 
Restoring global files, 4-8 
Restore System Job (RSJ) pro- 
gram, 1-14 
RKC (RK copy), 1-14 
Routines, 
Interpreter called, I-6 
Interrupt Service, I-19 
system global, I-3 
RSJ (Restore system job) program, 
1-14 
RST (Restore Devices program), 
1-14 
RUBOUT, 2-4, 3-10 
Running utility programs, 4-3 
Run-Queue, 1-9 


Save Global file, 4-8 

Save program (%PS), 1-16, 4-15 

Scheduling jobs, 5-12 

SDP (Sequential Disk Processor), 
1-14, 3-6, 3-34 

Segmentation of program, 5-10, 
5-12 

Semicolon (;) used as comment 
indicator, 2-8 

Sequential Disk Processor (SDP), 
1-14, 3-34 

SIF (Status Information program), 
1-14 

Sign-on processing, see Log-in 

Single numeric data, G-3 through 
G-6 

Size of program, 5-9 through 
5-12 

Software, 1-8 

Space reduction for program, 5-12 
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Spaces in arguments, 2-8 

Sparse array, 1-3 

SS (System Status program), 1-14 

SSD (System Shutdown), 1-14 

Stack, G-14 through G-16. 

Starting a Library Utility pro- 
gram, 4-3, 4-4 

Starting a program, 2-13 

Status Information program (SIF), 
1-14 

Status register, magtape, 3-17 

Step numbers, 2-8, 2-10, G-1l2, 


G=-15 
Stopping a Library Utility pro- 
gram, 4-4 


Stopping a program, 2-13, 4-4 
Storage Allocation maps, 1-12 
Storage on-line, 1-1 
Storing programs, 2-11, G-12 
String data, G-7 
storage, 5-12, 5-14, 5-15, 
5-16 
String node, G-7, G-8 
String value, 1-3 
STU (System Startup), 1-15 
Supervision, I/O device, 1-9 
Switch Register switches, 5-18 
assignments and bit masks, 
5-19 
Symbolic variable, 1-3 
Symbols used in manual, xiv 
Symbol table, 5-10, G-15 through 
G-19 
Space conservation, 5-11 
Symbol usage, xiv, D-l 
Syntax rules for commands and 
functions, 2-8 
SYSGEN (System Generator pro- 
gram), 1-15 
SYSTAB (System Table), F=-2 
through F-6 
System, 
data structures, G-l 
device, 1-8 
hardware, 1-1 through 1-8 
memory size, 1-2 
queue information, F-10 
software, 1-8 
tables, reference data, F-l 
UCI (UCI #1), 1-13, 4-1 
Utility programs, 1-13 through 
1-16 
System Caretaker program (CTR), 
1-14 


System Generator program (SYSGEN), 


1-15 
System Shutdown program (SSD), 
1-14 


System Startup (STU), 1-15 
System Status program (SS), 1-14 


System Status Information program, 


(SIF), 1-14 


System Table (SYSTAB), F-2 through 


F=-6 
System Test Package, TPl through 
TP8, 1-15 
System variable, 
SA, 3-8, 5-2 (see also SA sys- 
tem variable) 


SB, 3-37 
SE, 3-8, 3-15, 3-21, 5-1, 5-4 
through 5-6 


SH, 3-11, 3-12 


$T (Time of Day) subroutine, 1-16, 


4-1, 4-15 
Table, 
device (DEVTAB), F-7 
job (JOBTAB), F-10 
partition (PARTAB), F-8, F-9 
system (SYSTAB), F-2 through 
F-6 
user class identification 
(UCITAB), F-7 
Table position, system tables, 
F-1 
Tabulation, 3-7 
Tape not ready condition, 3-22 
Techniques of programming, Chap- 
ter 5 (5-1) | 
Teletypes, 
preliminary operations, 2-2 
special characters, 3-10 
Terminals, 1-1, 2-1, 3-9 
Terminal state, CPU-CPU device, 
3-29 
Terminator of line, 2-4, 3-5 
Terms, glossary of, A-l 
Timed READs, I-13 
overrun, 5-4 
Time of Day subroutine (%T), 
1-16, 4-15 
Timesharing, 1-2, 1-8, 1-9, 3-1 
TIM Time routine, 1-15 
TPl through TP8 (System Test 
Package), 1-15 


‘TYPE command, 3-4 
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4U or “U (CTRL U), xiv Vertical bars (|), xiv 

UCI - see User Class Identifier VIEW command, 5-1, 5-5 

UCITAB, F-7 SVIEW function, 5-1, 5-2, 5-5, 

Underlines, xiv 5-6, F-8, F-9 

Unpacking buffers, I-10 VTO05/VT50, VT52, VT55 Video 

UNASSIGN command, 2-ll, 3-1, 3-2, Terminals, 2-2, 3-9, F=-12 
3-4, I-8 special characters, 3-11, 3-12 


Up-arrow symbol (+t), 4-15 

User classes within system, 1-4 

User Class Identification 
Table (UCITAB), F-7 


User Class Identifier (UCI), SW system variable, 5-5 
1-4, 2-1, 2-5 Wait-Queue, 1-9, 1-10 
UCI #1, 1-13, 4-1 Waking the job, I-20 
validity check, 1-10 WRITE command, 2-11, 3-4 


User stack, 5-10, G-14 
Space conservation, 5-1l 
User to Operator Communicator 
program (%OP), 1-16, 4-10 
Utility programs, 1-4, 1-12 $X system variable, 3-5, 3-8, 
running, 4-3 F-l1l1, F-13, F-15 
summary, 1-14 through 1-16 


Validity check, 1-10 SY system variable, 3-5, 3-8, 
Variables; F-ll1, F-13, F-15 

global, 1-3 

symbolic, 1-3 

system global, I-3 
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READER'S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. Problems with software should be reported 
on a Software Performance Report (SPR) form. If you 
require a written reply and are eligible to receive 
one under SPR service, submit your comments on an SPR 
form. 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 


Student programmer 
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